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PREFACE TO SUPER UTILITY PLUS VERSION 3.2 



Super Utility Plus version 3 represents an entirely 
new program. Both program and manual have been 
rewritten almost from the ground up. The program has 
been endowed with new abilities which users have 
requested over the years that Super Utility Plus was 
on the market. The current release, Version 3.2, will 
deal correctly with some double-sided disks, and 
incorporates support the for the Radio Shack 
double-density modification for the Model I TRS-80. 
The new operating systems such as MULTIDOS, 
TRSDOS 2.7DD and DOSPLUS 3.5 are now fully 
supported. Also supported is TRSDOS 6 for the Model 
4 TRS-80™ computer. 



The manual has been rewritten to provide new users 
as well as old ones with more information regarding the 
operation of the program and the thinking that went 
behind it. Old users may find this manual a bit 
redundant in spots, but they should keep in mind that 
someone who is using this program for the first time 
may need that redundancy to help him learn how to use 
the program. Users are cautioned against skipping over 
the initial chapter. The first chapter of this manual 
contains information which will be assumed in the later 
sections of the manual. All users are urged to read the 
first chapter carefully before proceeding to use the 
program. 




A section has been included giving an overview of 
diskette structure as it pertains to TRS-80 systems. 
However, this manual is not intended to be a tutorial 
on how disk storage systems are organized. If you 
desire in-depth information on this subject, there are 
other publications available which may be of use to 
you. The classic is, of course, William Barden's TRS-80 
Disk Interfacing Guide. Another useful publication is 
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Inside Super Utility Plus 3.0 by Paul Wiener and Gary 
Camp. It contains much useful information which is also 
relevant to a user of Super Utility Plus 3.2. 

Super Utility Plus requires a minimum hardware 
configuration of 48K of RAM memory and at least one 
disk drive. The tape copy function will require two 
tape recorders. The efficiency of the program is 
considerably enhanced when two or more disk drives 
are available. 

The Super Utility Plus diskette is designed to boot 
up on either a 35-track, 40-track or 80-track disk drive, 
on the Model I or Model III TRS-80. It will also boot 
and execute on the Model 4 computer in its Model III 
mode. A separate version is available for the Lobo 
Systems MAX-80 computer, which is specific to that 
machine only. This program does not require any 
external support once it is loaded. Therefore, as soon 
as the program has been loaded and is running, you are 
urged to open drive 0, take out the Super Utility Plus 
diskette, and PUT IT AWAY. The less time it stays in 
the drive, the better its chances are against being 
damaged or destroyed by accident. 




REGISTRATION AND TECHNICAL SUPPORT 

Please fill out the registration card which came 
with your Super Utility Plus and mail it at your 
earliest opportunity to PowerSOPT, 11500 Stemmons 
Expressway, Suite 125, Dallas TX 75229. Registration 
of this product in your name will entitle you to receive 
technical support. Registered owners will be placed in 
our database and PowerSOFT will notify all registered 
owners of any upgrades, enhancements, fixes or new 
releases for this program. Owners who do not register 
this program will not be entitled to send their disks for 
upgrade or to receive any technical support. 



Copyright °1983 by Breeze/QSD, Inc 




USER'S MANUAL 



gr? ! w..:: , -! v , ! -3p 


'0\> : \'.:'}i 


ms^^i~mm 



If you are not sure whether or not to send your 
disks back to PowerSOFT for updating, please do the 
following: Boot up your Super Utility Plus disk and hold 
down the CLEAR and V keys. Note down the Version 
number, assembly date, and revision number which are 
displayed on the screen. Then contact PowerSOFT 
Technical Support and inquire what the latest version 
and revision numbers are. Compare them with what you 
have. If they are the same, there is no need to return 
your disks for updating. 



Super Utility Plus, to the best of our knowledge, 
contains no major bugs, but it is entirely conceivable 
that some minor bugs may exist somewhere in the 37K 
of machine code that make up this program. If you 
encounter a problem, please re-read the pertinent 
section of the manual first and determine whether or 
not it is a real problem. If you are unable to overcome 
it, please verify the exact circumstances under which it 
occurs and send a complete description of the problem 
to PowerSOFT Technical Support at the address above. 
Describe the problem as thoroughly as possible, and 
always include a complete description of your 
hardware configuration (type of computer, number and 
type of disk drives, etc.) . Also include your SERIAL 
NUMBER. We will do our best to assist all registered 
owners. 




If you have any urgent questions regarding the 
operation of this program, you may call PowerSOFT 
Technical Support at 214/484-9428 between the hours 
of 10 a.m. and 5 p.m. CENTRAL TIME, (i.e., 11 a.m. to 
6 p.m. EASTERN, 9 a.m. to 4 p.m. MOUNTAIN, or 8 
a.m. to 3 p.m. PACIFIC) Mondays through Fridays. If 
you are going to call, please have your serial number 
on hand. You will be asked for it, and you must supply 
it and be verified in the PowerSOFT customer data 
base before you can receive any technical support. It 
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would also help if you could be at your computer with 
Super Utility Plus booted up and running when you call. 

This program is supplied with a backup disk. If 
either disk does not load or operate properly, please 
return it to us for direct replacement within 10 days 
of purchase. Include a thorough explanation of the 
problem and the filled out registration card at the 
same time. If the problem is found to result from the 
use of non-standard hardware which PowerSOFT does 
not support, your disks will be returned to you 
unchanged. 

If your disks become unbootable and the program 
itself is not at fault (e.g., your dog chewed up one and 
your son poured soda over the other) you may send 
the disks back to us for replacement. The replacement 
cost is $8.00 per disk plus $5.00 if the disk is in 
unusable condition. Both disks can be sent back at the 
same time for update or replacement for $11, plus $5 
per disk if the disks are in unusable condition. These 
prices are subject to change without notice. 
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A NOTE ON NOTATION 

When using this manual, please take note of the 
following: 

This is a ZERO: 

This is ALSO a ZERO: Q 
This is the letter O: O, O 
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CHAPTER 1 - INTRODUCTION 



Super Utility Plus version 3 is an extremely 
powerful utility package for use on TRS-80 Model I, 
Model III, Model 4 (in its Model III mode) and Lobo 
Systems MAX-80 disk-based microcomputers. Like its 
predecessor, Super Utility Plus 2.2z, its many routines 
allow you, the user, to perform a great variety of 
tasks, ranging from direct examination and modification 
of the contents of a diskette to restoring an 
unreadable diskette to a usable condition. With Super 
Utility Plus you may also format diskettes in a variety 
of ways (including a mixed-density track!), backup a 
diskette to another using a very fast routine, examine 
a particular file on a diskette, or examine and modify 
the contents of your TRS-80's memory. 

This manual will explain the various utility routines 
available in release 3.2 of Super Utility Plus. Please 
read it carefully before attempting to use the program 
for the first time. Due to its power and versatility, 
Super Utility Plus can do great damage to your 
diskettes if carelessly used. 

It is assumed in this manual that you are familiar 
with your disk operating systems' features. More 
information on this may be found in your disk 
operating system manual. It is also assumed that you 
have a basic idea of how data is structured on 
diskettes. This manual is NOT a tutorial on data 
structures or disk I/O techniques. 

In this manual, any references to Model III also 
apply to the Model 4, since Super Utility Plus will 
execute on the Model 4 in its Model III mode. 
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OVERVIEW OP SUPER UTILITY PLUS 

These are the utilities available to you in the pro- 
gram: 



* * 

•• SUPER-UTILITY ! *» VERSION 3.1A ffff BY: KIM UATT H 
(C)(P) 1783 BREEZE/QSD, INC. - DALLAS, TEXAS 



UTILITY FEATURES 

1 ZAP UTILITIES 

2 PURGE UTILITIES 

3 FORMAT UTILITIES 

4 BACKUP UTILITIES 

5 REPAIR UTILITIES 



CHOICE? * 



6 TAPE UTILITIES 

7 MEMORY UTILITIES 
B FILE UTILITIES 

? CONFIGURATION 

10 EXIT PROGRAM 



Each selection is preceded by a number and repre- 
sents a group of utilities. By entering the appropriate 
number on your keyboard, you will be taken into a 
further menu which will allow you to choose from the 
utilities available in that group. 

ZAP Utilities are routines which permit you to 
directly examine, modify and copy the contents of a 
diskette. The routines in this group will also permit 
you to search a disk for a particular occurrence of 
bytes or characters. 
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PURGE Utilities will allow you to quickly and 
easily kill or recover files from a system or data 
diskette and clean up your directory in the process. 
You may optionally remove all traces of a file from a 
diskette, change the diskette name, and view the disk 
directory before and after making changes. 

DISK FORMAT Utilities are routines for formatting 
a diskette in a variety of ways. You may construct 
format tracks to your own specifications, even tracks 
with mixed single and double density sectors. You may 
even reformat a diskette without losing any data 
previously written on it! There is even a routine 
which removes all traces of data from a diskette, in 
effect bulk-erasing it. 

The BACKUP Utilities will perform standard or 
special backups of one disk onto another. The 
destination diskette may optionally be formatted 
before backup begins. These backup routines are very 
fast and very intelligent. 

The REPAIR Utilities will let you restore an 
unreadable disk directory or damaged boot sector to a 
usable condition, if at all possible. You may also 
recover files which were killed by Super Utility Plus, 
and check the disk directory for any errors which may 
result in the destruction of files later on. 




TAPE Utilities will allow you to perform a variety 
of tape-to-tape or tape-to-memory tasks. 500 baud tape 
rates are supported by these routines. Tape utilities 
are not available for the MAX-80 computer. 

MEMORY Utilities will perform a variety of func- 
tions of the RAM memory of your TRS-80. You may 
examine the contents of memory, move the contents of 
a segment of memory to another location, search me- 
mory for the occurrence of a particular string, read a 
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port, send a byte to a port, and transfer memory to 
disk and vice-versa. Additionally, you may also 
transfer to your own machine-language subroutine in 
memory. 

FILE Utilities are similar to the ZAP utilities, 
except that they are file-oriented. You may use them 
to view the contents of a file on a diskette without 
knowing exactly where on the diskette the file 
resides. You may compare two files for differences, 
copy files from one diskette to another, display the 
free space on a disk, display the locations of files on 
a disk, create new files, and check the status of your 
disk drives. 

The CONFIGURATION system allows you to tailor 
Super Utility Plus to your own system. You can tell 
Super Utility Pius the characteristics of your lineprin- 
ter, if you have one, how many disk drives you have, 
and what kind of disks you expect to be using in each 
drive. You can also optionally software write protect 
a particular disk drive so that no data on it can be 
inadvertently changed. The configuration parameters 
may be saved on disk for automatic loading when the 
program is rebooted. 




EXECUTING SUPER UTILITY PLUS 



The Super Utility Plus program is supplied on a 
special "self-booting" diskette. Insert the Super Utility 
Plus diskette into your drive and press the RESET 
button oiu your computer. The Super Utility Plus logo 
will appear on the screen while your disk drive 
continues to run. After a few seconds the disk drive 
will stop, and the logo will animate. Press any key 
and the program will bring up the main menu. 
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You should be aware that during the entire loading 
process, Super Utility Plus is performing a memory 
test on your computer's RAM to ensure correct 
operation of the program. If the message "memory 
error" appears on the screen, you should get your 
computer's memory tested and replaced if necessary. 

Former versions of Super Utility Plus would display 
the program labels if you held down the left or right 
arrow keys during the bootup process. This version no 
longer has that feature. All the program labels and 
register conditions are documented in the Super Utility 
Plus 3.2 Technical Manual. 




Super Utility Plus does not require the presence of 
a DOS system disk in drive at all. Nor does it 
require the presence of its own disk in drive 0. Once 
you have successfully brought up the main Super 
Utility Plus menu, remove the Super Utility Plus disk 
from the drive and put it in a safe place. You should 
never keep the Super Utility Plus diskette in the drive 
any longer than absolutely necessary. 

Super Utility Plus is menu-driven, that is, its va- 
rious functions are accessed through a series of menus 
which appear on your screen. By keying in the 
appropriate number for the routine you want, you will 
activate that particular function. Simply pressing 
ENTER will default to the first selection on the 
displayed list. To exit a function at any time, press 
the BREAK key. To return to the main menu at any 
time, hold down the SHIFT key and press BREAK. 

If you are prompted for additional input after se- 
lecting a routine, you may enter requested numeric 
information in either decimal (the default base), 
hexadecimal (by appending H after the number), octal 
(by appending the letter O or the letter Q to the 
number), or binary (by appending B to the number). 
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String input may be typed in directly, and lower case 
may be used at any time. SHIFT-0 ("shift-zero") acts 
as a reverse case toggle. Pressing it once will lock 
you into reverse case (normal upper case, shifted keys 
lower case), pressing it a second time will restore 
normal upper/lower case. On a Model 4 computer, the 
CAPS LOCK key will work in identical fashion to 
shift-0. 




When several inputs are requested, you may enter 
them separated from each other by commas, as you 
would when answering a BASIC prompt for multiple 
numbers. Alternatively, the inputs can be separated 
from each other by spaces. 

In addition to the various keyboard functions, 
Super Utility Plus has a powerful screen printer built 
right into the program. Pressing SHIFT-CLEAR at any 
time after the main menu has been brought up will 
cause whatever is displayed on your screen to be 
reproduced on your iineprinter. If your lineprinter is 
capable of producing TRS-80 block graphics, you can 
configure Super Utility Plus to do so; otherwise it will 
change graphics symbols to "JT signs before printing. 

When a display is scrolling on the screen, as when 
you select "File Allocations" from the Utilities menu, 
the display may temporarily be frozen by pressing the 
spacebar. Pressing ENTER will cause the program to 
resume. 



In addition to the various key controls, five con- 
trol combinations are active at any point of the pro- 
gram. These are: 

Clear-A - Turns the moving graphics characters at 
the corners of the screen ON or OFF. 



m*. 
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Clear-V - Displays the Super Utility Plus version 
number and the assembly date of your copy. It also 
displays the revision number of the current version. 
This will help you in determining whether or not to 
send your copy in for an update. Before sending your 
disks back for update, contact PowerSOFT and inquire 
what the latest version and revision numbers are, and 
compare them to those on your disk. If they are the 
same then you do not need to return your disks. 

Clear-I - Toggles an INKEY function. When turned 
ON, single-key responses to prompts will be acted 
upon immediately. Otherwise, the program will wait for 
the ENTER key to be pressed. This function works 
only on those prompts which take a MAXIMUM of 
ONE keystroke for a reply. If a prompt can accept 
more than one keystroke maximum, then you will need 
to press the ENTER key still. 

Clear-T - Toggles the trace display. This will 
display the contents of the current program counter in 
the upper right of the screen. 

Clear-S will display the serial number of your 
Super Utility Plus disk. 

These control combinations require that you hold 
the CLEAR key down and press the second key. In 
addition, note that they are also subject to automatic 
keyboard repeat. In the case of Clear-A, Clear-I and 
Clear-T, which have toggle functions, holding them 
down too long may cause them to toggle twice, with a 
net effect of zero. If nothing seems to happen when 
you press these keys, you may have held them down 
too long. 

The main menu presents you with the various 
groups of utilities available in the program: 
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ZAP Utilities 
PURGE Utilities 
FORMAT Utilities 
BACKUP Utilities 
REPAIR Utilities 



Super Utility Plus 3.2 



6 - TAPE Utilities 

7 - MEMORY Utilities 

8 - PILE Utilities 

9 - CONFIGURATION 

10 - EXIT Program 




By entering the number to the left of each 
selection and pressing ENTER, you will be taken to a 
further menu which will present you with the various 
routines available under that group (in the MAX-80 
version of Super Utility Plus, there are no tape 
utilities, and the following choices are numbered 
correspondingly one lower than above). Pressing 
ENTER alone will always take you to the first 
selection on the displayed menu. 

The following chapters will deal with each group of 
utilities in detail. Please read each chapter carefully 
and keep the manual handy while using Super Utility 
Plus. We cannot emphasize enough the dangers of 
using this program in a careless fashion. If you are 
not sure of something, check the manual. 
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CONFIGURING SUPER UTILITY PLUS 

Super Utility Plus may be configured to your 
system very easily. In the main menu, you will see a 
selection that reads, "CONFIGURATION." If you press 
the number 9 on your keyboard, you will see a display 
that looks like this: 



. H SUPER-UTILITY + » VERSION 3.1A M BY: KIM UATT H 

(C)(P) 1983 BREEZE/QSD, INC. - DALLAS, TEXAS 
I 

CONFIGURATION 
=>DUAL=N GRAPHICS=N L0CASE=N LINEFEEDS=N D0UBLER=R SPEEDS 
. +:0 T3D' PTKS* 40 RTKS= 40 U1R» 17 STP=3 RDLY=4 UDLY=4 UP=N 

D0=D DD=D LS0=1 HS0=18 LSD=1 HSD=1B S/G=3 G/T=6 DD=I 
. tH T3D' PTKS= 40 RTKS= 40 DIP* 17 STP=3 RDLY=4 U0LY=4 UP=N 

00=D DD=D LS0=1 HS0=1B LSD=1 HSD=18 S/G=3 G/T=6 DD=I 
. \:l TIB' PTKS= 35 RTKS= 35 D1R= 17 STP=3 RDLY=4 UDLY=4 UP=N 

D0=S DD=S LS0=0 HS0=0? LSD=0 HSO=0? S/G=5 G/T=Z DD=S 
. +:3 T1S' PTKS= 35 RTKS= 35 DIR= 17 STP=3 RDLY=4 UDLY=4 UP=N 

D0=S DD=S LS0=0 HS0=0? LSD=0 HSD=0? S/G=5 G/T*2 DD=S 
. ? f 



There are several lines to the display, and you will 
see a little arrow to the left of the top line: 

-> Dual-N Graphics-N Locase-N Linefeeds-N 
Doubler™R Speed-N 
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The arrow indicates which line is being worked on, 
and you can bring it down by simply pressing the 
ENTER key. 

The first four items on this line pertain to your 
system's lineprinter and its characteristics. DUAL re- 
fers to whether or not you want dual output on or 
off; if you turn it on, everything that appears on your 
screen will be sent to the lineprinter simultaneously. 

GRAPHICS refers to whether or not your line 
printer is capable of printing the TRS-80 block 
graphics symbols. If this is turned on, then Super 
Utility Plus will send the graphics codes out to your 
lineprinter. Otherwise, it will replace all graphics 
symbols with pound signs C#")- 

Some printers can generate the TRS-80 block gra- 
phics, but do not use the same ASCII codes as the 
computer uses. An example of this is the popular 
EPSON MX-series printers. If you are using an EPSON 
MX printer, you may force the correct offset by 
entering GRAPHICS-M {For "MX"). This will cause 
Super Utility Plus to output the correct graphics 
codes. Note, however, that later MX-80 models no 
longer have the TRS-80 block graphic codes in them 
so that this will have may have an undesirable 
effect. Along with other printers they must be 
considered as being incapable of generating the 
graphics codes, since Super Utility Plus does not 
possess any ability to offset the computer's internal 
graphics codes to the codes that the printer uses. 

LOCASE simply refers to whether or not your line 
printer can print lowercase letters or not. If turned 
on, Super Utility Plus will send all lowercase codes as 
is; otherwise, lowercase codes will be translated to 
uppercase before sending to the printer. 
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LINEFEEDS tells Super Utility Plus if your line 
printer requires linefeeds after a carriage return to 
move to the next line. Most Radio Shack lineprinters 
do this automatically, and normally this option would 
be left off. 



To turn the options on or off, simply enter Y (yes) 
for on, or N (no) for off, for each option. For 
example, if you wanted to set your options as follows: 
Dual mode on, no graphics (your printer can't generate 
them), lowercase on, linefeeds off, you would enter on 
the command line: 

? Y,N,Y,N 




and press the ENTER key. Note that you only have to 
enter the answers, but they must be in the correct 
relative position. As soon as you hit enter, you will 
see the top line change to reflect your answers, and 
the arrow ( -> ) will move down to the next line. 
Invalid answers will cause the line to be prompted for 
again; no change will take place in the configuration 
tables beyond the incorrect entry. 

The next item on this line is applicable to Model I 
users only, and allows you to indicate to Super Utility 
Plus whether or not you have a Doubler (a double- 
density adaptor) installed in your machine. It is 
normally set to DOUBLER-R, indicating the presence 
of a Radio Shack doubler (the MAX-80 version will 
show "Doubler=M"). If you do not have a doubler 
installed, you should change this to indicate N. This 
will prevent Super Utility Plus from making any 
attempt to read a double-density disk. If you have a 
double density board installed that is not a Radio 
Shack kit, enter X (for "Brand X"). In any case, Super 
Utility Plus can usually determine which type you 
have, and will alter this setting accordingly. 



Copyright °1983 by Breeze/QSD, Inc. 




L 



16 



Super UtUity Plus 3.2 



DOUBLER-N is invalid for Model III, 4 or MAX-80 
and will not be accepted by the program. Users of 
these machines should leave the setting as they find 
it. This will prevent inadvertent disabling of double- 
density I/O on these machines. 

The last item on this line is SPEED and is used to 
toggle a CPU speed-up modification. If set to Y Super 
Utility Plus will assume that, if you are using a Model 
I, you have the Archbold speed-up modification 
installed in your computer; otherwise, that your 
computer is a Model 4 and will toggle the CPU to 
operate at high speed and adjust accordingly (due to 
the Model 4's numerous memory and video wait states, 
the realized speed gain on a Model 4 is minimal). If 
you are using some other cpu speed-up modification, 
you may insert the code necessary to turn your 
particular high speed modification ON and OFF 
following the SPEED parameter. There are no prompts 
on the configuration line for this, but you may enter 
up to 8 hexadecimal bytes each for the ON code 
(preceded by 0=) and OFF code (preceded by F=). If 
you enter less than 8 hexadecimal bytes, the string 
will be padded with NOPs by Super Utility Plus. For 
example, if your high speed modification was turned 
on by an LD A,l and OUT (OFEH),A instruction and 
off by an LD A,0 and OUT (OFEH),A instruction, you 
could enter 3E01D3FE for the on code and 3E00D3FE 
for the off code, as follows: 




... (preceding input) Y,O-3E01D3FE,F-3E00D3FE 

The next lines refer to the disk drives in your 
system. Each drive is described by two lines, but only 
the options on the first line may be changed; the data 
on the second line for each drive is implied from the 
first. 

Let's take a look at the entry for drive 0: 
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">+:0 T3D* PTKS-40 RTKS-40 Dir«17 Stp=3 Rdly=4 
Wdly-4 Wp-N 
DO=D Dd=D LSO-1 HSO-18 LSd=l HSd=18 
S/G-3 G/T-6 DD-I 



To the left of the drive number is a plus sign. This 
means that Super Utility Plus will recognize that drive 
as being in the system. If it were a minus, then Super 
Utility Plus will assume that it is not in your system 
and will refuse to do any I/O to it. You can change 
this by typing a minus sign as the first character in 
the prompt line. 

If you had only two drives, and 1, for example, 
you might want to remove drives 2 and 3 from the 
system. In this way, if you should inadvertently 
reference drive 2 or 3, you will be informed that the 
drives are not available in the system. 

You may also specify "=", indicating that Super 
Utility Plus should operate in "SKIP" mode for this 
drive. This is used only when trying to read a 35 or 
40 track diskette in an 80-track disk drive {NOTE: 
NEVER write to a 35 or 40 track diskette while it is 
in an 80-track drive. This disk may not be readable in 
a 35/40 track drive afterward.) 






T3D' is a DOS SPECIFIER. This tells Super Utility 
Plus what Disk Operating System (DOS) it can expect 
to find in that drive. On the Model I, the default is 
T1S, or TRSDOS 2.3 single density. On the Model III 
the default is T3D, for TRSDOS 1.3 double density. 
On the MAX-80, the default is L3D, or LDOS double- 
density. The DOS specifiers recognized by Super Utili- 
ty Plus are given below. Note that whenever more 
than one item appears in the Model I or Model III 
column for a particular DOS type, these items are 
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equivalent in meaning and may be used interchange- 
ably. 



DOS 


Model I 


Model III 


TRSDOS 






Sgl. Den. 


T, Tl f TS, T1S 


* invalid * 


Dbl. Den. 


T1D 


T3, TD, T3D 


LDOS 






Sgl. Den. 


L, Lil f Ls, Lis 


L, LS, L3S 


Dbl. Den. 


LID (SOLE disk) 


L3, LD f L3D 




(note 1) 


(Note 4) 


LDOS 8" (MAX-80 version only) 




Sgl. Den. 


n.a. 


XS, X1S, XI 


Dbl. Den. 


n.a. 


X3.X3D 


DOSPLUS 






Sgl. Den. 


D, Dl f DS, D1S 


D, DS, D3S 


Dbl. Den. 


DIEKsystem disk) 
(note 1) 


D3, DD, D3D 


MULTIDOS 






Sgl. Den. 


M, Ml, MS, MIS 


M, MS, M3S 


Dbl. Den. 


MlD(system disk) 


M3, MD, M3D 
(note 1,2) 


NEWDOS80 V2 




Sgl. Den. 


N, Nl f NS, N1S 


N, NS, N3S 


D. Den. 


NlDR(Tk rev.) 


N3R, NDR, N3DR 
(note 1,2,3) 


DBLDOS 






Dbl. Den. 


B, Bl, BD, BID 


* invalid * 



Note 1: For model I data disks which do not have 
the single density track 0, use one of the 
Mod III codes. 

Note 2: Relative sectoring as required by 
NEWDOS80 V2 double density disks is 
specified by appending the letter R to 
the specifier, e.g., N1DR. This is man- 
datory for correctly handling ND80 V2 
(except for Model I double-density 
Standard Backup) and DBLDOS double- 
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Note 3: 



Note 4: 



density systems in file and directory- 
oriented operations. The R modifier is 
allowed only in MultiDOS Model I double- 
density to produce the "P-density" disks. 
For NEWDOS80 V2 diskettes with a nor- 
mal Track 0, use one of the correspon- 
ding Mod III specifiers. 
Use L3D to operate on TRSDOS 6 disks. 



As you can see from the table above, the system of 
DOS specifiers used in Version 3.2 of Super Utility 
Plus is considerably changed from earlier versions. 
Now you have a choice of which specifier to use, and 
you can select whichever is most meaningful for you. 

The M R" modifier allows Super Utility Plus to 
correctly handle disks which use a relative 
track/sector formatting scheme, such as NEWDOS/80 
Version 2 double density disks. This modifier is 
mandatory for all double-density operations under 
NEWDOS/80 V. 2 EXCEPT for Model I STANDARD 
BACKUPS. When doing a standard backup on a Model 
I, use N1D only. However, if you run into problems 
with this modifier, try repeating the operation -- but 
leave the "R" off the DOS specifier. 




Double sided media support : Limited support for 
double-sided media is now available in this new re- 
lease of Super Utility Pius. Only LDOS, DOSPLUS and 
the new version of MULTIDOS are supported (the old 
version of MultiDOS, which used a separate directory 
for each side of a double-sided disk, is NOT 
supported). A double-sided disk is specified by 
appending a double-quote to the DOS specifier, e.g., 
L3D" or DD". Conversely, a single-quote appended to 
the DOS specifier indicates a single-sided disk. Most 
functions, with the exception of COPY FILES, can be 
performed on double-sided disks. COPY FILES is valid 
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for double-sided disks only on the MAX-80 version of 
Super Utility Plus . 

The DOS specifiers may also be used within the 
other routines of Super Utility Plus to override the 
configuration table settings without returning to the 
configuration routine. To override the current setting, 
append the required DOS specifier to the drive number 
on a prompt line. For example, when prompted for 
drive, track and sector, you might enter something 
like this: 

0M3D'-40,21,5 

By appending M3D to the drive number, you are 
telling Super Utility Plus that the disk in that drive is 
now a Model HI double-density MULTIDOS disk. -40 
indicates that is it formatted for 40 tracks. Similarly, 
when asked for a filespec, the following form can be 
used: 

MYFILE/BAStfUT-^O 




to indicate that the disk containing MYFILE/BAS in 
drive 3 is a double-sided double density LDOS disk. 
The use of the override system avoids the necessity 
of having to return to the configuration routine each 
time you wish to scan a different disk type. 

PTKS-40 is the number of formatted physical 
tracks that Super Utility Plus expects to find on the 
diskette in drive 0. If you are going to put in a 
diskette with a different track count in this drive, 
you should change this figure. 

RTKS-40 refers to the number of relative tracks 
on the diskette,. For systems that use a relative track 
scheme, like NEWDOS/80 Version 2, this figure will 
differ from that- of PTKS. Note: this item is not user 



'.. : : .V' 



fctti 
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controllable. Do not enter this value "when changing a 
drive configuration. It is automatically calculated from 
the PTKS value. 

DIR-17 tells you which track the diskette directo- 
ry is located in. If a relative track scheme is being 
used, this value should be the relative and not the 
physical track location of the directory. This value 
may be left as is; Super Utility Plus is capable of 
locating the directory by itself. 

STEP-3 refers to the head stepping rate of your 
disk drive. This is a coded value, and the correspon- 
ding rates are as follows: 






6 milliseconds 


1 


12 milliseconds 


2 


20 milliseconds 


3 


30/40 milliseconds 




A standard Radio Shack Model I disk drive is normally 
capable of stepping its read/write head from one 
track to the next at 20 milliseconds, although some 
may be slower (older drives cannot step faster than 
40 milliseconds). Model III Radio Shack drives are for 
the most part capable of stepping at the fastest rate, 
6 milliseconds. You should consult the drive's 
specifications for the correct rate. Do not specify a 
step rate faster than the drive is capable of, or you 
will produce I/O errors which can ruin your disk. If in 
doubt, set the step rate to 3 (almost all disk drives 
are capable of this speed). 

RDLY-4 refers to the delay (in quarter-seconds) 
from the time a drive's motor comes on to the time 
when Super Utility Plus first attempts to read from 
the disk. If set to M 4", there will be a one-second 
delay from motor-on to the first read attempt. This is 
normally more than enough to let the drive come up 
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to speed. If you find that Super Utility Plus is having 
trouble reading your disks for the first time, you may 
need to set this delay factor to "4". 

WDLY-4, conversely, controls the amount of delay 
from the time the disk motor comes on to the time 
Super Utility Plus first attempts to write to the disk. 
If set to "4", Super Utility Plus will delay 1 second 
before attempting a write operation. If set to "2", it 
will wait only one-half second. Since writes are more 
critical than reads, this delay factor is controlled 
separately to ensure reliable writes to the disk. Again, 
if disk I/O errors occur as a result of bad writes to 
the disk, you may wish to make sure this item is set 
to "4". 

Both RDLY and WDLY can take values from 1 to 
4. A value of (theoretically, no delay) is invalid and 
will be rejected. 

WP-N is a "switch" which tells Super Utility Plus 
whether or not to "write-protect" your drive. If you 
specify "Y" to this, Super Utility Plus will read any 
diskette in that drive, but will not write to it. This is 
functionally equivalent to putting a write-protect tab 
on your diskette. 

The second line contains information about the 
disk's formatting. 

DO-D indicates the density of track 0. Some disks 
have track formatted in a different density from the 
rest of the disk. One example of this is a double- 
density Model I LDOS system disk to which the 
"SOLE" modification (a trademark of MISOSYS, 
Alexandria, VA) has been applied to permit it to boot 
up. Such a disk has a single-density track 0. This item 
will indicate S for single density or D for double 
density, and pertains to track of the disk only . 
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Dd=*D indicates the density of the rest of the disk. 
Dd stands for "Density of disk." This will be S for 
single and D for double. 

LSO-1 indicates the sector number of the lowest 
sector on Track 0. TRSDOS 1.3 numbers sectors from 
starting from 1. All other systems number their 
sectors from 0. 



HSO-18 tells you the sector number of the highest 
sector on Track 0. For a single-density disk, this will 
be 9. For TRSDOS 1.3 this will be 18. Double density 
Model I disks which are designed to boot up on that 
computer will show this value as 9 (MAX-80 users 
note that the value will be different for 8" disks). 

LSd=l indicates the sector number of the lowest 
sector on the rest of the diskette's tracks. This will 
be 1 for TRSDOS 1.3 and TRSDOS 2.7DD, for all 
others. 




HSd-18 is the number of the highest sector on the 
rest of the diskette's tracks. This value will be 18 for 
TRSDOS 1.3 and TRSDOS 2.7DD, 9 for other single- 
density non-RS systems and 17 for double density 
systems (MAX-80 users will see other values for 8" 
disks). 

S/G indicates the number of sectors per granule . 
Since the granule is an arbitrary unit, its size can, 
and indeed does, vary. A single density disk will have 
5 sectors per granule. A double-density TRSDOS 1.3 
and 2.7DD disk will have 3 sectors per granule. 
Double-density LDOS, DOSPLUS and MultiDOS disks 
use 6 sectors per granule. 

NEWDOS80 V2 uses "lumps" instead of granules, 
and the size of a lump can vary. If you are going to 
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work on a NEWDOS80 V2 disk with Super Utility Plus, 
your disk should be configured as closely as possible 
to the standard "granule" sizes as defined in the 
preceding paragraph. Super Utility Plus cannot 
correctly handle lump sizes that are widely different. 
The configuration table will always show 5 sectors per 
gran on relative sectoring. 

G/T stands for granules per track . This value will 
obviously vary according to the way a granule's size 
is defined. For TRSDOS 1.3 and 2.7DD, this will be 6. 
For single density disks (TRSDOS and other non-RS 
systems) it will be 2, and for double density non-RS 
systems it will be 3 (NEWDOS80 disks will show 2 
grans per track on relative-sectored diskettes). 

DD indicates the type of data address marks used 
by the disk. Each disk writes one type of data 
address mark for the data tracks and another type for 
the directory track. For all operating systems except 
TRSDOS 1.3, this will read S meaning "standard 
convention," meaning that data tracks are written with 
standard data address marks and the directory track 
with read-protected data address marks. For TRSDOS 
1.3, it will read I for "inverted." 

Note that the information on the second line of 
each drive configuration is IMPLIED from the first 
line, and therefore cannot be changed directly by the 
user. Only the items on the first line can be changed, 
with the sole exception of RTKS. 




To alter the settings, you must enter a series of 
answers to the prompt which describe your disk drive. 
The settings in the example above would have been 
given by this string: 

?+,T3,40,17 f 1.4,4,N 
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The + is optional and indicates that the drive should 
be active in the system; the rest of "it indicates that 
Super Utility Plus should expect a TRSDOS 1.3 <T3) 
disk with 40 formatted tracks, a directory on track 
17, in a drive capable of stepping at 12 milliseconds 
(1 - see table above) requiring motor-on delays for 
both reads and writes, and that the drive should not 
be write protected. Note also that the side specifier 
is not entered, and will default to * (single sided 
disk). 



If we were to change the specifications to a 
single-density model I disk, we might enter, 

?+,TlS,35 

T1S indicates that the disk in the drive will be single 
density TRSDOS 2.3, and will have 35 tracks. The 
rest of the information is the same and does not have 
to be entered. In most cases, it is also unnecessary 
to pre-set the directory track; Super Utility Plus will 
find it. 

If you wish to take a drive out of the system, it 
is only necessary to enter the - to disable that drive 
-- the other specifications will obviously not matter. 




. :V: 3s 



JiTiWiii 



In general, the only things that really need to be 
configured are the lineprinter specifications, and for 
each drive the DOS type, step rate, motor-on delay, 
the software write-protect switch, and whether or not 
a particular drive is to be actively in the system. The 
track count and directory location of the disks are 
determined when Super Utility Plus goes to read a 
diskette in the specific drive, and will change 
accordingly. Sometimes, if you swap a disk of a 
different density into that drive, read it, and then 
view the configuration table, you will see that the 
table has changed to reflect the density of that disk. 
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If you are configuring your disk drives in an 
identical manner, (e.g., all of one DOS type), you may 
simply configure the first drive of that type. Then, 
with the pointer on the next drive, enter on the 
prompt line: 

<d 

where "d" is the drive number whose configuration 
characteristics you want copied into the current drive. 
For example, if you had configured drive to 
DD",40,20, etc., and you want the exact same confi- 
guration on drive 1, you would move the pointer down 
to the drive 1 configuration listing and enter on the 
prompt line, <0. The configuration characteristics of 
drive will be copied into drive l's control table. 

Conversely, if you want to copy the configuration 
data of one drive to another drive, position the => 
pointer to the source drive (the drive you want the 
configuration data copied from) and enter a >d at the 
prompt line. So if you wanted to copy the con- 
figuration of drive into drive 3, for example, you 
would position the -> at drive 0, and then type >3. 
The configuration information of drive will be copied 
to drive 3. 

Other modifiers may follow the ">d" and "<d" 
specifications. For example, you might enter on the 
prompt line, 

<0,L3D,80,40 




This would FIRST copy the drive configuration of 
drive into the current drive. THEN it would alter 
the current drive's specifications to indicate an 80- 
track drive with a directory on track 40. 
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Note that if you are going to use these specifi- 
cations, "<" or ">" must be the first character on the 
line. If it is not the first character on the line, the 
whole line will likely be rejected. 

After you have configured Super Utility Plus' disk 
drive settings to your specifications, press ENTER 
once more. You will now be asked whether you wish 
to save the configuration or not. If you reply "Y", you 
will be asked to mount the Super Utility Plus diskette 
in drive 0. Make sure there is no write-protect tab on 
the disk. Press ENTER. Your configuration will be 
written out to the disk and will automatically be 
established the next time you boot Super Utility Plus 
up. 
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OVERVIEW OF DISKETTE DATA STRUCTURE 



When you format a diskette using the FORMAT 
program from your system disk, information is written 
to the diskette in concentric rings called tracks. On a 
Model I TRS-80, each diskette is divided, or 
"formatted," into 35 tracks (some newer operating 
systems use the term cylinders to allow for the 
possibility of double-sided disks). The newer model I 
drives can be formatted to 40 tracks, but this depends 
on the operating system. TRSDOS 2.3 normally 
recognizes only 35. On a Model III, a diskette is 
normally formatted into 40 tracks. 



Each track in turn is divided into sectors. The 
number of sectors on a track depends on the dis- 
kette's density. Model I TRS-80's normally format 
diskettes in single density unless they are equipped 
with a double density modification, in which case they 
can format either single or double density. Model III 
TRS-80s format them in double density. A single 
density track contains 10 sectors, while a double- 
density track contains 18 sectors. Note that these are 
the actual, physical numbers of sectors on a track. 
What the operating system CALLS them can be 
different. But whatever the density of the diskette, a 
sector will always contain 256 bytes of data (unless a 
special formatting scheme was used) plus some 
additional bytes of information which identify the 
sector to the computer in terms of its track and 
sector location. 

Each sector has two fields, the header field and 
the data field. The header field is a 6-byte field 
which consists of an address mark, a track designator, 
a head designator, a sector number designator, a 
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length byte, and a two-byte CRC (see below). There is 
no separate field for a track number; -this is specified 
in the as part of the header data for every sector on 
the track. The head designator is used to identify 
which side of a double-sided diskette the sector is on. 

Following the sector number is a length byte, 
which is an encoded value of the number of data 
bytes in the sector. TRS-80 diskettes normally use 
IBM conventions, in which a length byte corres- 
ponds to 128 bytes of data, 1 corresponds to 256 
bytes, and so on. See the next chapter for an expla- 
nation of non-IBM conventions. In double density dis- 
kettes, only IBM length values from 00 to 03 are 
valid, corresponding to lengths of 128, 256, 512 and 
1024 bytes per sector respectively. 

The header fields are placed on the diskette at 
format time, and are never altered unless the disk is 
reformatted. The second type, however, is the data 
field, and that is changed each time the sector is 
written to. This field contains the actual data for the 
sector along with 2 CRC bytes. 

Each field (header and data) is preceded by a gap 
consisting of 12 bytes of FFH and 6 bytes of 00H. 
These bytes are placed there to separate the sectors. 
Note that depending on the formatting and density, 
the gap bytes may be some value other than FF or 
00. There is no firm convention established as to what 
these bytes should be. 




The header and data fields on each sector are 
each preceded by an address mark which is used by 
the FDC to detect the start of a block of data. The 
address marks are also used in the TRS-80 disk ope- 
rating systems to identify a track as being a part of 
a directory track, or part of a data track. This is 
discussed below. 
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Both the header and the data fields include two 
Cyclic Redundancy Check, or CRC, bytes at the end. 
These two bytes are the result of an extremely fast 
polynomial calculation performed by the floppy disk 
controller chip on the data being written out to the 
disk (at format time for the header fields, and at 
sector write time for the data fields). When data is 
read back in from the disk, the CRC bytes are 
recalculated and compared with the values placed on 
the disk. If they are the same, then the data was 
read in correctly. If they are NOT the same, then the 
data was not read in correctly, and the operating 
system will normally try again. If, after a preset 
number of tries, the operating system cannot read the 
data in correctly, an error condition is declared. The 
message seen by most TRS-80 users when this type of 
error occurs is usually "Parity error," or "CRC error." 




The sectors on each track are grouped together 
into arbitrary units called granules, or "grans." A gran 
is the smallest unit TRSDOS (or a TRSDOS-compatible 
system) will allocate to a diskette file. Machine- 
language programs, BASIC programs, and data files are 
all "files" to the system and are assigned granules of 
space on the diskette as needed. As a file grows {for 
example, in a mailing list file which is being added to) 
the DOS will assign more grans to it to hold the 
additional data. The use of this grouping prevents 
excessive thrashing around of the disk drive's 
read/write head and also allows for faster file 
accesses. A single-density diskette, such as that 
produced by Model I systems without the Radio Shack 
double-density adapter, will have two grans of 5 
sectors on each track. A Model III TRSDOS double- 
density diskette will have six grans of three sectors 
each per track. Most double-density non-RS diskettes 
will have three granules of six sectors each per track. 
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When a file is saved to disk, it may occupy se- 
veral grans of space. It is the job of the disk ope- 
rating system to keep track of where the file is 
located on the disk, and how much space it takes up. 
Sometimes a file must be broken up into several 
segments, or extents, in order to make maximum use 
of the available space on a diskette. The disk opera- 
ting system keeps track of all this and maintains 
information on each file in a special place on the disk 
called the directory track. 



When you request a file, such as what happens 
when you issue the RUN "filename/ext" command from 
Disk BASIC, the DOS first goes to the diskette's 
directory track and looks for the file you specified. If 
it finds the file, the system then examines the 
information associated with it to find out where on 
the disk the file resides, and how long it is. Armed 
with this information, it then goes to the spot on the 
disk where the file begins, and proceeds to load it 
into the computer's memory. 




The directory track is "marked" off from the rest 
of the tracks on the diskette by the use of a special 
data address mark , or DAM. This is a piece of 
information written onto the disk by the DOS during 
the format process, and permits it to locate the 
directory track quickly, since it is different from the 
address marks used on the other tracks. However, 
the type of DAM written to the directory is 
dependent on the hardware in the machine, specifi- 
cally, the floppy disk controller chip. The Model I 
uses a different controller chip than the Model III. 
This poses certain problems, the major one being the 
fact that you cannot read a Model I single-density 
TRSDOS disk's directory on a Model III without 
changing the ID marks to ones the Model III can 
read. Reading Model III diskettes on a Model I, 
however, poses no problems if the Model I is equipped 
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with a double-density adapter because the adapter 
board will have both types of FDC chips on it. Other 
operating systems avoid this problem by using a data 
address mark for the directory track that both Model 
I and Model III controller chips can read and write. 

The directory track, then, is one of the most 
important parts of a diskette. If the directory track is 
damaged in some manner so that the operating system 
cannot correctly read the information on it, the disk 
essentially becomes unusable. The file itself is still on 
the disk, but the system no longer has any way of 
finding it. 

There is one other place on the disk which is vital 
to the operation of a system disk. This is the very 
first sector on the first, or outermost, track of a 
diskette. This sector is called the boot sector. On a 
Model I TRSDOS single-density diskette, and on all 
other non-RS systems' diskettes, this will be Sector 
of Track 0; on a Model III TRSDOS diskette it will 
be Sector 1 of Track 0. When a system disk is placed 
in Drive and the TRS-80's RESET button is pushed, 
special code in the ROMs orders the disk drive to 
move its read/write head to track and read the 
boot sector into memory (starting at 4200H for the 
Model I, 4300H for the Model III). Once the boot 
sector is in memory, the computer jumps to its 
starting address. This sector contains information 
which then permits the computer to read the rest of 
the operating system into memory. If the diskette is 
not a system diskette, the boot sector produces the 
"NO SYSTEM" notice on your screen. 

If the boot sector on a system disk is damaged, 
that disk also becomes unusable as a system disk, 
although it may still be possible to use it as a data 
disk. Super Utility Plus has the capability of resto- 
ring to a usable condition disks which have sustained 
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damage to the directory track or boot sector, if the 
damage is not too extensive. Sometimes the damage is 
so widespread that no recovery is possible, but in 
many cases, a disk can be restored to working con- 
dition at least long enough for you to copy important 
files over onto another diskette. 

Many users who find that one of their system disks 
will not boot automatically assume that the boot 
sector has been damaged. This may not necessarily 
be the case. The process of bringing a DOS up to the 
point where it is ready to accept user input consists 
of several steps, and a failure at any one of these 
steps may give the impression that the boot sector is 
bad. However, it may be that the resident module 
(SYSO) has been damaged, is missing or is in the 
wrong place; or that the command interpreter (SYS1) 
is damaged or missing. Users who are unaware of this 
process will simply assume that the boot sector need 
to be repaired, and will proceed to do so. But when 
the system still fails to come up then they may 
become confused and think that somehow Super Utility 
Plus has developed a bug or malfunction, when in fact 
it may have done exactly what they wanted. Exactly, 
but no more. 

When this happens to you, it pays to explore other 
possibilities before assuming the something is wrong 
with the program. Try copying a good SYSO or SYS1 
module from an undamaged disk onto the bad one. 
That may be all you need to get the system up and 
running again. 



Tracking down disk drive problems 

Super Utility Plus gives you a powerful set of 
tools with which to rescue glitched disks if necessary. 
However, it is important for the user to understand 
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why his disks got glitched in the first place. Did it 
happen because he placed the disk beside a magnet, 
or leaned it against a phone when the phone rang? Or 
was there a problem with the disk drives? 

If the problem lies in the disk drives, or the 
computer, it is vital to deal with the hardware before 
using Super Utility Plus, because it must work through 
that same hardware. If there are hardware problems, 
you could easily make matters worse by using Super 
Utility Plus! Like any other piece of equipment, disk 
drives should be properly maintained for optimum 
performance. 

Problems like "parity errors" or CRC errors can 
have a variety of causes. Below is a description of 
the most obvious and most common ones. 




DRIVE MOTOR SPEED - 5.25" drives turn at 300 
rpm. Sooner or later, as a drive begins to age, the 
speed begins to drift from 300. There is a fairly wide 
tolerance built into the drive electronics, however, and 
even though a drive's speed is no longer precisely at 
300, no errors occur. But if the speed drifts outside 
the allowable range, then disk I/O errors occur. 

There are two ranges to be concerned about. One 
is the critical range for formatting, which is generally 
plus or minus one percent, i.e., 297 through 303 rpm. 
A drive turning somewhere within this range will not 
normally have any problems with formatting disks. The 
second range to be concerned about is the critical 
range for standard disk I/O, and is generally plus or 
minus three percent, or 291 through 309 rpm. Once a 
drive's motor speed falls outside this range, then 
problems with disk I/O begin to occur. 

HEAD ALIGNMENT - A misaligned read/write head 
is a rare occurrence with the newer disk drives on 
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the market today, unless that drive has been subjected 
to mechanical shock or other abuse. Head misalignment 
problems usually manifest themselves in disk I/O 
errors on the higher tracks, or in I/O errors when 
reading or writing disks created on another drive. 
Head misalignment can often be a subtle problem and 
difficult to diagnose because unless the misalignment 
is severe, any disk created on a drive with a 
misaligned head will always be readable on the same 
drive, although not necessarily on others. 



WORN PRESSURE PAD - This is a problem which 
is responsible for more ulcers than it has been given 
credit for. The head load pressure pad is a small 
piece of felt or plastic material which holds the disk 
media against the read/write head (single sided drives 
only), much in the same fashion that a tape recorder's 
pressure pad holds the tape against the recording 
head. Eventually this pad gets worn down and 
insufficient pressure is then applied to the media, with 
resulting disk I/O errors. The rate at which it gets 
worn down depends on how heavily the drive is used, 
and whether the drive is of a type that "unloads" the 
head (actually, releases the pressure pad) or one that 
keeps the read/write head constantly loaded and in 
contact with the disk. This problem, obviously, does 
not occur with double-sided drives. 




DIRTY READ/WRITE HEADS ■ Just as a dirty 
recording head on a tape recorder will produce 
distortions in music, so a dirty read/write head on a 
disk drive will produce distortions in data. The 
read/write heads should be cleaned periodically (but 
never too often lest you damage the read/write heads) 
in order to maintain optimum performance. Disk drive 
head cleaning kits are available from a variety of 
suppliers, and are a good investment. Follow the kit 
manufacturer's instructions on how to clean the disk 
drive heads. Unless your drives are in an exceptionally 
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dirty environment, one cleaning every six months or so 
should suffice. 




LOOSE OR DAMAGED DRIVE CABLES - A disk 
drive cable which comes even slightly loose at the 
computer end or at the disk drive end can give rise 
to a multitude of disk I/O errors. Make sure the 
conectors are always fastened tightly. 

MEDIA WEAR - Although we would like them to 
last forever, diskettes have a limited "lifespan." 
Generally a diskette lasts for about 60 to 70 hours of 
constant head contact, which is a fairly long time 
considering the fact that the head is in contact with 
the media only for very short periods at a time. The 
first portion of a diskette to go is usually the 
directory track, since that track is accessed anywhere 
from five to fifty times more often than the rest of 
the disk. 

These are a few of the most obvious and most 
common problems with hardware. There are others, but 
those require the testing equipment found in a service 
center to track down. 

What are the symptoms to look for? Below are 
desrciptions of some of the more common ones, and 
their possible causes. In describing these symptoms, it 
is assumed that they are occuring on good-quality 
diskettes and not on diskettes bought at a garage 
sale. Poor quality diskettes can produce ALL of these 
symptoms too! 



1. Format locks out sectors all over the disk -- 
drive speed out of critical range, dirty r/w heads, or 
worn pressure pad. 

2. Intermittent or random errors during formatting - 
dirty r/w heads__or worn pressure pad 
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3. Disk I/O errors on the high (inner) tracks - head 
misalignment, worn pressure pad. 

4. Inconsistent formatting (same disk formats OK 
one time, locks out sectors when reformatted five 
minutes later) - dirty r/w heads, worn media, or worn 
pressure pad. 

5. Disk I/O errors on a diskette created on 
another drive or computer - head misalignment 

6. Random I/O errors on directory track - worn 
media. 



7. Consistent I/O errors all over the disk 
speed outside critical range. 



drive 



These symptoms should alert you to the possibility 
that your disk drives need servicing. 

Troubles can also originate within the computer, 
but such problems are harder to track down and 
the task should be left to a competent technician. 
You can help him by noting down the exact 
circumstances under which the problems occur, so that 
if necessary he can duplicate them under controlled 
conditions. 
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CHAPTER 2 - ZAP UTILITIES 



Bring up the main Super Utility Plus menu as 
described above, and press 1. You will then be pre- 
sented with the ZAP Utilities menu. 



I 



IX SUPER-UTILITY + H VERSION 3.1A « BY: KIM UATT «» 
(CMP) 1963 BREEZE/QSD, INC. - DALLAS, TEXAS 



ZAP UTILITIES „ 

1 DISPLAY SECTORS 

2 VERIFY SECTORS 

3 COMPARE SECTORS 

4 ~ COPY SECTORS 

5 " COPY SECTOR DATA 

6 " ZERO SECTORS 



I 



CHOICE? « 



7 REVERSE SECTOR DATA 

8 EXCHANGE SECTORS 

9 " STRING SEARCH 

10 " SECTOR SEARCH 

11 READ ID MARKS 

12 ALTER DATA ADDRESS MARKS 



Select the routine you want by entering its num- 
ber and pressing the <ENTER> key (see previous 
chapter for enabling INKEY-style entry). 




I. DISPLAY SECTORS 

When this option is selected, you will be presen- 
ted with an additional prompt: 

Drive, Track, Sector ? 
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Enter the number of the disk drive containing the disk 
you want to examine, then the track number and 
sector number you wish to display. Separate them 
from each other with a comma, for example, 

Drive, Track, Sector ? 1.0.1 

and press ENTER. If you wanted to read a diskette 
with a differing track count or density on the same 
drive, an alternative form would be 1T1S=40,0,1 where 
T1S indicates that the diskette is single density 
TRSDOS, and =»40 means it is formatted for 40 tracks. 
See the previous chapter's discussion on configuring 
the system for more details. If you omit the track and 
sector, you will be shown the lowest sector on the 
lowest formatted track on the disk. If you enter D for 
track, Super Utility Plus will go to the configured 
directory location. If you enter an up-arrow for the 
track, then you will be shown the highest configured 
track on that diskette. 

On this particular option only, you can also use 
two special symbols in front of the drive number. The 
first special symbol is a pound sign, or "8". This will 
cause Super Utility Pius to identify the diskette's 
density automatically, in case you are unsure of its 
density. This will work only with Display Sectors. This 
will also allow you to display non-standard sectors, 
however it will not scan the back side of a two-sided 
disk. 




The second special symbol is an exclamation mark, 
or "!." This switches in automatic format recognition. 
Super Utility Pius will examine the disk and determine 
whether it was formatted with sector numbers from 
to 17, or sector numbers from 1 to 18. This process 
takes a few seconds. This option is also available at 
any other routine which reads a diskette's directory. 
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The main purpose of this routine is to permit Super 
Utility plus to identify whether a disk is TRSDOS 1.3- 
formatted or LDOS compatible, and to render a disk 
readable to Super Utility Plus' I/O routines. It is up 
to the user to decide whether Super Utility Plus' 
identification of a disk as TRSDOS 1.3 or LDOS is 
sufficient for his purposes or whether he should go in 
further. 



The particular sector you requested will be dis- 
played on your screen. It will look something like this: 



* 


008F5DB E02F 2173 4477 2CA6 2808 2C1F 


HEX 


1082CB7 20FB CDBE 4020 1BF1 E1FB C9F5 


DRV 


208E5DD E511 D244 055E 2C56 EBE9 DDE1 


Q 


3Q8C1F1 18DC 3007 C5CD 5047 CI 18 DC3A 


TRK 


408CB67 20D5 2105 443E C396 20CD 772A 


00 


508F1E3 FBC9 C0F8 01C3 3040 5F45 5F45 


TRU 


6085F45 5F45 5F45 5F45 5F45 5F45 5F45 


00 


7085F45 1129 3505 3E0B CD37 453E 09CD 


SEC 


B083E0A C037 453E 0BCD 3745 2188 4234 


09 


9080707 6F26 4522 6245 5E2C 56D5 DDE1 


STD 


AQ82356 EBE9 D13A 6245 0F11 5F45 FE0C 


ODD 


BQ86F26 45F3 732C 72FB C95E 4521 0000 




C0856EB D118 EEFD 7E03 EE40 FD77 0301 




D08CB77 2803 0111 45F0 7107 FD70 0818 




ED8A7C8 FE07 CAD5 46D2 1C46 FE06 2853 


too 


F0B11FD 3405 FE04 0658 2B6B F036 0500 



3B0D8888/!SDU,8(.,.B. 
C5D58i8 Um .8888888 
E1D1888B.8D8 A ,V888888 
2B44888.80.88PG8.8:|D 
064488G 8!.D>88 8UX.D 
5F458888888.803 E E E 
5F458 E E E E E~E~E~E 
37458 E.)58>.87E>.87E 
7EE6»>.87E>.«7E!8B4~tt 
EB5E8..0&E u BE A ,Va888* 
D00788V888:BE.. E8.8. 
5E2380«,E8S,R88 A E!.. A 8 
09248V88.88~.838U...$ 
1B7B88U(...E8Q.8P...X 
302B8888.88F8.F8.(S=( 
D601M4.I..XIKI6.... 




This display contains a wealth of information. The 
leftmost column contains information about the display. 
HEX refers to the current modification mode base (see 
below). DRV and the number directly beneath it refer 
to the drive number just accessed. TRK and the 
number beneath it refer to the current track number, 
TRU and the number beneath it refer to the actual 
track number written on the disk, and SEC and the 
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number beneath it is the sector being displayed on the 
screen. 




Below the sector number is a three-letter code 
which identifies the particular data address mark 
written on the disk when the it was formatted. Super 
Utility Plus will identify four types of data address 
marks: STD, or standard, DDT, or deleted data, RPT 
or "read-protected", and UDF, or user-defined. The 
terms are those used by the manufacturer of the 
floppy disk controller chip and are not necessarily 
meaningful except insofar as they differentiate one 
type of address mark from another. TRSDOS uses a 
different type of data address mark for the directory 
track than for all the other tracks on a diskette and 
this is the major difference you need to be concerned 
about. 

The floppy disk controller chip used by the Model 
III can only recognize two of the four types of DAMs: 
STD and RPT. The table below indicates the 
equivalent types for Mod I and Mod III as used in 
Super Utility Plus: 



Model I STD & RPT - Model III STD 
Model I DDT & UDF - Model III RPT 
Model III STD - Model I STD 

Model III RPT - Model I UDF 



Below the data address mark identifier the density of 
the diskette being examined will be displayed. This 
will normally be OSD for single-density Model I 
diskettes and ODD for double density diskettes. Super 
Utility Plus has the capability to recognize the density 
of a diskette it is reading and switch between single 
and double density if you specify the special "#" 
symbol in front of the drive number. The first 
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character of the density ID string is "0" or "1" 
depending on which side of the disk is- being read. 

At the very bottom of the leftmost column of in- 
formation you will see +00. This indicator is used by 
a special feature of Super Utility Plus called 
decryption which will be explained in a later section. 

The next column gives you the relative byte 
numbers (in hexadecimal) of the data immediately to 
the right of the graphics border. "Relative byte" 
position simply means the position of a particular byte 
with respect to the first position, designated 00. Each 
row of the display shows 16 bytes with their values in 
hexadecimal format. Each group of four hexadecimal 
digits represents two bytes. 

The data read from the disk sector is displayed 
between the two graphics borders, and to the right of 
each row is the ASCII representation of these bytes. 
Values which do not represent displayable ASCII 
characters (below ASCII 32) are displayed as periods. 
Also, if you are using a machine not equipped with 
lower case, any lower case alphabetic character will 
be shown in upper case; however the HEX value will 
always be accurate. 

LI Paging 

You can use the arrow keys to page across 
sectors. The right-arrow key will page forward one 
sector, the left-arrow key will page back one sector. 
Pressing the up-arrow key will take you to the same 
sector on the next higher-numbered TRACK, while 
pressing the down-arrow key will take you to the same 
sector on the next lower-numbered track (unless you 
are already at the lowest). In addition, there are a 
number of other paging controls, given in the table 
below. 
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TABLE 2-1 - PAGING CONTROLS 



KEY 



Right arrow 

Left arrow 

Up arrow 
Down arrow 
SHIFT-Right arrow 

SHIFT-left arrow 

SHIFT- ) 
SHIFT- ( 
SHIFT-Up arrow 

SHIFT-Down arrow 

R 

T 

S 



ACTION 

pages one sector higher (or to 
the lowest sector of the next 
track if the current one is the 
last for this track) 
pages one sector lower (or to 
the highest sector of the prece- 
ding track if the current one is 
the lowest for this track) 
pages one track higher, same 
sector 

pages one track lower, same sec- 
tor 

pages one sector higher but will 
not leave current track (see 
note) 

pages one sector lower but will 
not leave current track (see 
note) 

displays highest sector on cur- 
rent track 

displays lowest sector on current 
track 

pages to the same sector on the 
highest track (defined in the con- 
figuration tables) 
pages to the same sector on the 
lowest track 

displays Track 0, Sector (Sec- 
tor 1 on TRSDOS 1.3 and 2.7DD. 
displays prompt for new Track, 
Sector 
displays prompt for new sector 
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. or > 

, or < 

number keys 0-9 

BREAK 

SHIFT-BREAK 

@ 

H,D,B,0,Q,A 
M 
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displays prompt for new Drive, 
Track, Sector 

pages to the next higher VALID 
sector 

pages to the next lower VALID 
sector 

displays the correspondingly num- 
bered sector on the current 
track 

returns you to the ZAP Utilities 
menu 

returns you to the main menu 
enables DECRYPT mode (see be- 
low) 

Sets modification mode BASE to 
hexadecimal, decimal, binary, oc- 
tal (0 and Q are equivalent) or 
ASCII. 
Enters modification mode. 



NOTE 1: Shift-right arrow and shift-left 
arrow may occasionally display 
sector numbers that are beyond 
the expected range. This will 
happen when Super Utility tries 
to read non-standard sectors and 
is not a cause for concern. 

NOTE 2: Depending on the case setting, 
you may need to use either @ or 
shift-® to enter decryption mode. 

NOTE 3: If you are attempting to display 
sectors with non-standard sector 
numbers, use > and < instead of 
the arrow keys. 

As you can see, the ZAP utility provides you with 
tremendous flexibility in searching through a disk. You 
can view any sector on the disk with relative ease. 
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One of the most powerful commands in Super 
Utility Plus is the L or LAST command. When you are 
viewing a sector and exit to the menu, either 
deliberately or accidentally, you can always return to 
the sector you were viewing by calling up the drive, 
track and sector prompt line and simply entering d L 
where "d" is the drive number and "L n takes the place 
of the track and sector values (the space is 
mandatory). You will immediately be returned to the 
last sector you were viewing. 

The value of LAST is updated by a number of 
routines. When performing a sector comparison, the 
last sector in which a mismatch was found will update 
LAST. Thus if you were comparing two disks and 
wanted to scan the mismatch, you would merely press 
CLEAR to stop the routine, request DISPLAY DISK 
SECTORS, and when the prompt for drive track and 
sector comes up, enter the drive number followed by 
L and you will be taken to the sector where the 
mismatch occurred. 

When performing a string search (see below), the 
last sector in which a string match was found will 
also update LAST. 




1.2 Modifying the contents of a disk sector 



The ZAP utility gives you the powerful ability to 
directly modify the contents of a disk sector. This 
should only be undertaken with great care, since 
careless modification can make a file or a disk totally 
useless for other purposes. 

Display the sector you wish to modify using the 
instructions given above. Then look at the leftmost 
column on your screen. On the second row you will 
see HEX displayed. Super Utility Plus' ZAP utility 
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gives you the ability to modify the contents of a disk 
sector in either Hexadecimal, Decimat, Octal, Binary, 
or ASCII form. The default is hexadecimal, and this is 
what the HEX means. Press D on your keyboard, and 
you will see it change to DEC. Now press A, and ASC 
will be displayed, meaning that ASCII modification is 
enabled. The keys for switching the modification case 
are H for hexadecimal, or Q for octal, D for 
decimal, B for binary, and A for ASCII. 



Press H again. Now press M. You will see a pair 
of flashing cursors appear in the data portion of the 
display, one in the hexadecimal portion, and another in 
the corresponding position in the ASCII display to the 
right. 

The cursor may be positioned anywhere in the data 
portion using the arrow keys. The right arrow moves 
the cursor one byte to the right, the left arrow moves 
it one byte to the left. The up and down arrows move 
the cursor up and down the rows. By holding down 
the SHIFT key and pressing one of the arrow keys, 
you can position to the far ends of the display. For 
example, pressing SHIFT and the right arrow key will 
position the cursor to the rightmost byte on that row. 
Pressing SHIFT and the down-arrow key will move the 
cursors to the bottom row of the display. The current 
position of the cursor, in relative byte format, will be 
displayed at the upper left of the screen. Pressing the 
CLEAR key will return the cursor to the upper left 
position (byte 00). The other positioning keys available 
in MODIFICATION MODE are given in the 
following table. 
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TABLE 2-2 - Modification Controls 



Key 
H,D,B,0,Q,A 



Action 

selects modification mode 
base (Hexadecimal, Decimal, 
Binary, Octal or ASCII). This 
should be done before ente- 
ring Modification mode, 
reset modification mode (per- 
mits reselection of H, D, O, 
Q, B, or A). 

moves cursor one byte to the 
right. 

moves cursor one byte to the 
left. 

moves cursor up one row. 
moves cursor down one row. 
moves cursor to last byte on 
row. 

moves cursor to leftmost byte 
on row. 

moves cursor to top row. 
moves cursor to bottom row. 
returns cursor to relative 
byte 00 (leftmost byte of top 
row). 

moves cursor to the last byte 
of the bottom row. 
moves cursor to the specified 
relative byte location (not 
active if in ASCII modifica- 
tion mode). 

moves cursor to the next oc- 
currence of specified numeric 
input, i.e., n L3F" will place 
cursor on the next occurrence 
of 3F in that sector (not ac- 
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SHIFT-ENTER 

Right Arrow 

Left Arrow 

Up Arrow 
Down Arrow 
SHIFT-Right Arrow 

SHIFT-Left Arrow 

SHIFT-Up Arrow 
SHIFT-Down Arrow 
CLEAR or S 



G + relative byte no. 



L + numeric input 





USER'S MANUAL 
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and numeric input 



P + numeric input 



ENTER 
BREAK 

SHIFT-BREAK 
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tive in ASCII modification 
mode). The - numeric input 
MUST be in the current modi- 
fication base. 

moves the cursor that many 
bytes forward from its cur- 
rent position. 

moves the cursor back that 
many bytes from its current 
position. 

insert data at current cursor 
position and move the rest of 
the data one byte to the 
right. 

delete the data beneath the 
cursor and shift the rest of 
the data one byte to the left, 
copy the byte beneath the 
cursor the specified number 
of times to the right. The 
numeric input must be in the 
current modification base, 
zeroes out display and holding 
buffer from the current cur- 
sor position on. 
terminate modification mode, 
abort modification mode, re- 
turn to ZAP utilities menu, 
abort modification mode, re- 
turn to main Super Utility 
Plus menu. 



Note that the keys being used in 

modification mode are the same as 

those used in PAGING mode, but have 
entirely different actions. 
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Extreme care should be taken when using the 
modification mode controls, as the result may not be 
what you expect. 

By typing a valid key (that is, a key valid for the 
current modification mode you are in), you will enter 
that value into the display at the current cursor 
location. For example, 

DD FEU 3ED0 D3F0 2102 D022 EA43 AF32 
HEX 1G CD3E 43FE D128 DCFE 022D E7CD 3E43 

In this case the cursor is under F0 on the first row. 
If you now enter a valid numeric digit, say 7, the 
first row would look like this: 

DO FEU 3ED0 D3___ 2102 0022 EA43 AF32 

Note that the cursor has changed, and the byte you 
are modifying has temporarily disappeared. Super 
Utility Plus is reminding you that you need to enter 
another hex digit to complete the modification of that 
byte. Now type D. The row now looks like this: 

00 FEU 3ED0 D37D 2102 0022 EA43 AF32 

F0 has been replaced with 7D, and the cursor has 
moved one byte over. 

The cursor will remain in its changed state until 
you have entered the necessary number of digits to 
enter a new value. This will vary depending on the 
modification base you are using. For example, if you 
are in BINARY modification, you will normally have to 
type in 8 binary digits before the new value appears 
on the display. If you wish to terminate the input 
early before entering all the digits, simply press 
ENTER. The binary value will be padded on the left 
with the requisite number of zeroes so as to evaluate 
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properly. To abort an entry simply type in an invalid 
digit and press ENTER. 

No matter what modification base you use, the 
display will always appear in hexadecimal, with the 
corresponding ASCII equivalents on the right. 

In ASCII modification, all keys on the keyboard 
except for the arrows, the greater-than and less-than 
symbols {> and <), BREAK, CLEAR and ENTER are 
valid for input. On the Model 4 and MAX-80, the 
CTRL key may be used for ASCII modification in 
combination with other keys; however you should be 
aware that certain control-key combinations may be 
seen as commands by Super Utility Plus, and will be 
acted upon as such. For example, a CTRL-D will 
terminate the modification mode immediately. This is 
not a bug, and should not be considered as such. 

Pressing ENTER terminates modification mode. You 
will now be presented with the prompt: 

U>pdate, R>eturn to modify, or C>ancel ? 




The modified sector will be written out to disk when 
you press ENTER or explicitly choose the Update 
option (type U and press ENTER). The sector data 
will be written back out to disk, and then re- 
displayed. Remember, UPDATE is the default, and 
hitting ENTER alone will select it. 

If you enter R, you will be returned to the sector 
display, and the disk will not be updated. You can 
continue making modifications. The display will contain 
the modifications you have made up to that point. 

Pressing C cancels the modification session. All 
your changes will be canceled, and the sector will be 
re-displayed with its original data intact. 
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1.2.1 Using the special modification controls 

The greater-than key (>) permits you to insert data 
into the display without having to retype what is 
already there. All the other bytes will be shifted one 
byte to the right, with the last one being lost. 
Conversely, the less-than key (<) will delete the byte 
beneath the cursor and shift all other bytes one place 
to the left to fill in the gap. The last byte, which 
was shifted OUT when you pressed ">", will NOT be 
brought back in. 

While in a numeric (not ASCII) modification mode, 
you can use a number of other keys to make changes 
to the displayed sector data with ease. 

The G key allows you to move directly to any 
position in the displayed sector without having to use 
the arrow keys. Simply type G followed by the 
relative byte position you want to go to, and the 
cursor will be placed on that position. The number 
following G will be interpreted in the current 
modification base (except when the modification base 
is ASCII, of course). For example, 

DO DOFE 11CD C701 FD21 DDDD 3A02 4257 1EE4 
HEX 10 0651 CDAB 4220 5801 E650 FE50 2056 2A16 




60 1823 10F6 18CA CD7E 426F CD7E 4267 C721 



The cursor is positioned at relative byte 5, which 
holds the byte 01. We want to position the cursor to 
relative byte 67 hex, which is 7E. To do this, just 
type G67. The cursor has now been positioned where 
we want it: 
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DD DDFE 11CD C901 FD21 DDDO 3AD2 4257 1EE4 
HEX ID 0651 CDAB 422D 58D1 E650 FE5D 2056 2A16 



60 1823 10F6 18CA CD7E 426F CD7E 4267 C921 



The LAST variable is also updated by this 
command, so that if you reposition the cursor and 
later wish to return to the original byte, simply typing 
GL will get you there. The use of the L will allow 
you to reposition the cursor with a minimum of 
keystrokes. 

The + and - keys operate in a similar fashion. 
Typing a + followed by a number in the current 
modification base will move the cursor forward that 
many bytes from its current position. If the number 
entered was such that it would cause the cursor to 
leave the display, the cursor will be positioned at the 
last byte of the display. Typing a - followed by a 
number will move the cursor back that many bytes 
from its current position. 

Another handy control is L. This permits you to 
locate a particular byte on the display and position 
the cursor over it. In the example above, suppose the 
cursor was at relative byte 00, and you wanted to 
locate the byte whose value was 21 hex. Type L21. 
The cursor will immediately be positioned over relative 
byte 7. Now press L21 again. The cursor is now 
positioned at relative byte 6F hex, which is also 21H! 
Remember however, that like the G command, the 
number which follows L is also interpreted in the 
current modification base. 
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Instead of repeatedly pressing L21, however, you 
could also enter LL. The second L refers to the "last 
value entered" and would produce the same results. 
This is also available in the G command. 




For quick positioning to the start and end of the 
display, the S and Q keys are available. The S key 
will move the cursor back to the first byte on the 
display, while the Q will move it to the last byte on 
the display. 

Sometimes you want to duplicate a certain byte a 
specific number of times. You can do this very easily 
with the P key. In the example above, suppose you 
wanted to replace the entire first row with 00. 
Position "the cursor over the first byte, which is 
already 00, press P, and OF. The rest of the row, 15 
bytes all in all, have been replaced with 00 (OF hex 
=15 decimal). As with the G and L commands, if your 
modification base was decimal, you would have had to 
enter P15, since the number would be taken in the 
current base. Note that the command POO (P zero 
zero), which would normally be interpreted as 
"propagate this byte 65,536 times", is invalid and will 
not be accepted by Super Utility Plus. 

The S, Q, G, L, +, - and P commands are obviously 
not usable when you are in ASCII modify mode, 
because in this mode all keys except for the four 
arrow keys, >, <, BREAK and ENTER are valid input. 

For zeroing out the display and the contents of the 
holding buffer, you may press Z. This will immediately 
remove all data from the holding buffer and replace 
them with 00 bytes starting at the current cursor 
position. 
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1.3 Bit-shift operations 

While you are in paging mode, you may perform 
various bit-shift and bit-rotate operations on the 
displayed data. These operations are analogous to 
those performed by the Z-80 assembly language 
instructions RLCA, RRCA, SLA, and SRL. They involve 
shifting the bits of an 8-bit byte a specified number 
of times to the left or right to form a new value. In 
shift operations, the bits at the far end are usually 
lost, while in rotate instructions, the bits at the far 
end are "rotated" into the opposite end. For example, 
take the binary representation of the value 85 
(decimal): 



01010101 

To shift this byte 1 place to the right would yield the 
value 

10 10 10 

or 42 decimal. The trailing 1 bit has been lost. 
Shifting the original number left one place would give 
you 

10 10 10 10 

or 180 decimal. Shifting it left two places yields the 
binary value 



01010100 



which is 94 decimal. 




Rotate operations involve moving the bit that 
would normally be lost at the far end into the 
opposite end of the bit string. Using our example, 1 
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1 1 1, If we rotate this value right one bit, 
the result would be 

10 10 10 10 

or 180 decimal. Rotating it left one bit yields 

10101010 
also 180 decimal! Rotating it left two bits gives us 

01010101 

bringing us right back where we started, at 85 
decimal. Other numbers would give other results, of 
course. 

Shift and rotate instructions can be carried out for 
any number of places you wish, up to 7 (the width of 
one byte). In Super Utility Plus, if you wish to 
execute a shift or rotate instruction, you must first 
be in the paging (not modification) mode. The shift or 
rotate operations are carried out on ALL the displayed 
data bytes simultaneously. To see how this works, 
first display a sector and make sure you are in the 
paging mode. Now press @. Toward the bottom of the 
display at the left side, you will see the prompt 

DCR 

with a line beneath it (DCR stands for "decryption" - 
this routine can be used to investigate sectors which 
may have been encrypted either by bit shift, logical 
or increment/decrement operations). 

To execute a Rotate Right operation, press RR 
followed by the number of places you want to rotate 
each byte on the display. You will see the bytes 
change as soon as you hit ENTER. To execute a 
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Rotate Left operation, type RL followed by the 
number of places to rotate and press ENTER. SR 
followed by a number executes a shift right operation, 
and SL executes a shift left operation. 

In addition, this particular routine is capable of 
carrying out a variety of logical operations on the 
displayed data. The commands are listed below. Each 
command must be followed by a numeric input (the 
base must be properly identified by appending H, B, 0, 
or Q -- decimal is the default - to the number) and 
ENTER: 



A AND the displayed bytes with given input 

OR the displayed bytes with given input 

X XOR displayed bytes with given input 

+ ADD the given input to each byte and display 

the result, modulo 256 

SUBTRACT the given input from each byte 

and display the result modulo 256 

You can also command the computer to increment 
or decrement the display automatically any given 
number of times. This may be useful if you wish to 
see if any ASCII words in the displayed sector have 
been encrypted by adding or subtracting a constant 
value to its ASCII value. It may be necessary to type 
"@" again to re-enter decryption mode as some of the 
commands automatically take you back to normal 
paging mode. 

While executing this operation, you can further tell 
the computer whether to update the ASCII side of the 
display only (the default), by entering "*" as the first 
character in response to the DCR prompt, or both the 
HEX and ASCII sides by entering ":". 




You can increment or decrement the display one 
bit at a time in decryption mode also. You would 
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enter decryption mode as usual, and select whether 
you want the HEX side only modified, the ASCII side 
only modified, or both. Then you would enter an 
up-arrow if you wanted an increment operation, or a 
down-arrow if you wanted a decrement operation (you 
cannot do both simultaneously). Finally you can control 
the speed at which the computer updates the display. 

Suppose you wanted to increment the ASCII side 
of the display and view the results. In response to 
the DCR prompt, you would enter * followed by an 
up-arrow (for incrementing) and finally a decimal 
number from 1 to 255 for speed (1 is the fastest, 255 
is the slowest). As soon as you press ENTER you will 
see the ASCII side of the display begin to change. 

You may stop this automatic operation anytime by 
pressing @, or you can pause it momentarily by 
pressing the spacebar. The display will stop updating 
when all the bytes reach the maximum value, FFH or 
255 decimal. Entering a T makes the changes 
permanent and must be the first character of a new 
DCR prompt line. 




This operation can be used to encrypt your own 
messages very easily. Suppose you had a sector of 
code which, among other things, contained the ASCII 
string "MYPROGRAM" and you wanted to hide the 
string by XOR'ing each byte with 88H. Enter 
decryption mode and make note of where the string 
MYPROGRAM starts in the sector. Then XOR the 
entire sector with 88H and use the "!" command to 
make the change permanent in the buffer. Now enter 
modification mode and place the cursor at the location 
where the string starts, and type in the string 
MYPROGRAM normally . Exit modification mode and go 
into decryption mode again. Now once again, XOR the 
entire sector with 88H. The rest of the sector will 
now be back to normal, but your string 
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"MYPROGRAM" will now become encrypted! Finally, 
use the "!" symbol to make the changes permanent and 
write the sector out to disk. 

The +00 on the bottom left of the display is 
updated to show the amount the data bits are shifted, 
rotated, logically operated on, or incremented or 
decremented by a DCR operation. The symbol 
preceding the two numbers will change to reflect the 
current operation, in accordance with the table above. 
Pressing ENTER in response to the DCR prompt will 
reset this number to 00. 



1.4 Error Recovery 

Should any I/O errors occur while Super Utility 
Plus is attempting to read or write to a disk, a 
message describing the type of error encountered will 
be displayed, for example, 

Sector NOT FOUND! 



or 



DATA CRC ERROR! 

and you will be given an option to retry the I/O 
operation with the prompt, 




R>etry, S>kip, Oontinuous, N>onstop or Q>uit ? 

for as many times as necessary. You may press R (or 
just ENTER) to retry the I/O operation once. If the 
error occurred as a result of some momentary 
condition, this is usually sufficient to correct the 
situation. However, if the error continues to appear, 
you may want to type C for continuous retries. This 
will force Super Utility Plus to retry the I/O 
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operation until it gets it right, or CLEAR is pressed. 
Pressing CLEAR will restore the retry prompt. Also, 
break and shift-BREAK may be pressed from the 
keyboard to abort the operation and return you back 
to a Super Utility Plus menu. Pressing N will produce 
the same results as Continuous, but in addition will 
automatically place Super Utility in continuous mode 
on subsequent errors. 




Pressing S will immediately bring up the sector 
display. Depending on the error encountered, this may 
or may not contain any data. If the sector could not 
be read at all, the display will contain all 00 bytes 
(the buffer is zeroed out before a sector read is 
performed). If Super Utility Plus was successful in 
partially reading the display, some data will be 
present in the display. However, you should not 
assume that what is shown on the display is an 
accurate representation of the data. If the error was 
simply a data CRC error, then the data may be intact. 
However, some bytes of data could also be garbled. 
You should examine the display closely and come to 
your own determination of whether the data displayed 
is intact or at least repairable. If you decide the data 
is intact, or have carried out the necessary repairs, 
then writing the sector back out to disk will 
automatically correct any CRC errors which may exist 
as long as the media is physically intact. 

Pressing Q will abort the operation in progress and 
return you immediately to the ZAP Utilities menu. 



II. VERIFY SECTORS 






This option allows you to scan all or part of a 
disk for conditions which would produce I/O errors. 
This routine does not check the data, but rather 
whether or not sectors are readable. You will be 
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prompted for the drive, track and sector to verify, 
and the number of sectors to verify. "The program will 
then proceed to read these sectors and report any 
errors which it encounters. 

When errors are encountered, the program will 
display an error message followed by the prompt to 
R>etry, S>kip, Oontinuous, N>onstop, or or Q>uit. If 
you press R, the program will attempt to read that 
sector again. If it succeeds, it will continue. If it 
does not succeed, it will re-display the error message. 



Pressing C or N for continuous re-try will force 
the program to re-read the bad sector UNTIL it gets 
it right. If it cannot read the bad sector at all, you 
may exit by pressing CLEAR, BREAK, or 
SHIFT-BREAK depending on where you wanted to go 
next. 

Skip tells the program to skip the bad sector and 
continue. The program will keep an internal count of 
the bad sectors encountered and will report the total 
number of bad sectors at the end of the operation. 

Quit simply brings the verification routine to an 
end at that point. You will be brought back to the 
ZAP utilities menu. 



III. COMPARE SECTORS 

This utility permits you to compare the contents of 
two different sectors and is useful if you want to 
verify that a backup operation made an exact copy. 
This routine will also check for data address mark 
mismatches. 
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When this option is selected, you will be prompted 
for the drive, track and starting sector number of the 
source disk. The program will then ask you for the 
number of sectors to compare (default is to the end 
of disk). When you have entered this number, you will 
then be prompted for the drive, track and starting 
sector location on the destination disk for the 
comparison operation. 







After this, you will be asked, "Prompt for disk 
mounts?" If you answer Y (yes), you will be told when 
to swap disks. This is especially usefui when you have 
only one drive in which to do the comparison. The 
number of disk swaps will be determined by the 
amount of memory available to Super Utility Plus for 
buffer space. On a two-drive comparison, of course, no 
disk swaps are necessary. However, you can use the 
disk mount prompts on a two drive system to check 
the readability of a disk on two different drives, 
should you suspect that the drive hardware is at 
fault. 

IV. COPY SECTORS 

This option will allow you to copy sectors from 
one disk to another, or from one location on the disk 
to another. Only full sectors are copied. When this 
option is selected, you will be prompted for the drive, 
track and starting sector of the source disk, and the 
number of sectors to be copied. Then you will be 
asked for the drive, track and starting sector number 
of the destination disk. As with the COMPARE 
SECTORS option, you will then be asked if you want 
to be prompted for disk mounts. If you reply Yes, you 
will be told when to swap disks. If your source and 
destination drives are the same, the disks you swap 
must be the same disk type. 
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The data will then be copied over to the new 
locations, leaving the original locations intact. The 
track and sector id fields will not be copied, but the 
correct DAMs and the actual contents of the sectors 
will be transferred. 

This procedure will NOT work correctly if used on 
sectors with non-standard lengths, i.e., lengths other 
than 256 bytes. Attempting to copy such sectors may 
have disastrous results and should not be attempted. 

Note that this operation is not reflected in the 
diskette's directory. You may use this routine to copy 
a file from one location to the other, but your 
directory will not show the file in its new location. 



V. COPY SECTOR DATA 

This option will allow you to copy partial sector 
data onto a new sector. You will be prompted for the 
drive, track and sector of the source disk, the 
relative byte number within that sector where the 
copy is to begin, and the number of bytes you wish 
copied. Then you will be prompted for the drive, track 
and sector of the destination disk, along with the 
starting byte position for the copy, and whether or 
not you want disk mount prompts. The copy will then 
proceed. You will be advised upon completion of the 
routine whether any disk I/O errors occurred during 
the copy. 

This routine will allow you to copy from 1 to 
65535 bytes of information to a new location of your 
choice. The same restrictions as COPY SECTORS 
apply to the use of this routine on non-standard 
length sectors. 
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VI. ZERO SECTORS 

This option will totally remove the data from the 
specified sectors, setting the entire contents of the 
sectors to 00 and resetting the data address marks to 
STD (RPT on Model III TRSDOS). You will be 
prompted for the drive, track and starting sector 
number for the operation, along with the number of 
sectors to zero. BE CAREFUL WITH THIS ROUTINE! 
Upon pressing the ENTER key the operation will 
immediately be carried out, and there is ABSOLUTELY 
NO CHANCE of recovering the data once a sector has 
been zeroed out! 




Do not use this routine to zero out directory 
sectors, as the directory sectors will be written out 
with the wrong DAMs. Use the "Zero Unused Entries" 
routine in the PURGE UTILITIES menu. 



VII. REVERSE SECTOR DATA 

This routine simply takes the data of a specified 
sector and reverses it, so that the byte that as in 
relative position 00 is now in relative position FFH 
and so on. This routine may be useful in creating disk 
protection schemes for machine language programs and 
data. If multiple sectors are specified then each 
sector will be worked on independently. That is, the 
reversal of sector data takes place entirely within 
each individual sector. 



VIII. EXCHANGE SECTORS 



This routine will exchange the data contained in 
one or more sectors with the data in another set of 



Copyright °1983 by Breeze/QSD, Inc. 





USER'S MANUAL 



65 



sectors. You will be prompted for the source drive, 
track and starting sector number, "along with the 
number of sectors to exchange. Then you will be 
prompted for the destination drive, track and starting 
sector number and whether or not you want to be 
prompted for disk mounts. Upon pressing the ENTER 
key the data in each sector on the source disk will 
be exchanged with the corresponding sector on the 
destination disk. Upon completion of the operation you 
will be advised of any disk I/O errors that may have 
occurred. 



IX. STRING SEARCH 

Up to an entire disk may be searched for a given 
ASCII string, BYTE list or WORD list (a word equals 
two bytes, a total of 16 bits) using this routine. 
Additionally you may optionally specify a replacement 
string which the routine will insert in place of the 
target string whenever the target string is found. 

You will be prompted for the drive, track and 
starting sector for the search, and the number of 
sectors to search. Next, you will be prompted to enter 
the search string, and lastly, the replacement string 
(if you do not wish to perform any replacement, 
merely hit ENTER in response to this prompt). If the 
length of the replacement string is shorter than that 
of the search string, only that portion of the search 
string which corresponds to the length of the 
replacement string will be replaced. This will permit 
you, for example, to search for all occurrences of 
"John Brown" and change them to "Carl Brown" by 
simply giving "Carl" for a replacement string. 




If the replacement string is longer than the search 
string, it will be truncated to the length of the 
search string. The disk will then be searched, and 



Copyright °1983 by Breeze/QSD, Inc. 




L 



66 



Super Utility Plus 3.2 



upon completion, the location of each match and the 
total number of matches found will be displayed. 

The search string must be contained wholly within 
a sector; that is, part of it cannot reside in one 
sector with the rest in the next sector. If this is the 
case, the routine will not find it. If you suspect that 
this may be the case, try performing a search on only 
a portion of the string. 




To search for an ASCII string, simply enter it 
when prompted. For example, if you wanted to search 
for an occurrence of the name "Jim", you would enter, 



"Jim' 



in response to the prompt. Enclosing the word in 
double quotes means that you want the search to 
match upper and lower case EXACTLY. If you wanted 
to find occurrences of "Jim" and "JIM" you would 
enclose the search string in single quotes . Single 
quotes tells Super Utility Plus to search for the string 
in a case-independent fashion, that is, upper and lower 
case differences will not matter. 

If you wanted to find all occurrences of "Jim" and 
"Tim" on the disk, you could enter, 

n ?im B 



warn 



in response to the prompt. The "?" is a wild-card 
character, meaning, in effect, "I don't care what's in 
this position, match it with whatever's there and show 
it to me anyway." 

To search out BYTE values, when you are promp- 
ted for the search string, enter a series of values in 
the range to 255 in any valid numeric base sepa- 
rated by commas or spaces. For example, 
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10H,13H,CDH 

which in decimal would be 

16,19,205 

Note that each element of the reply is separated from 
the rest by a comma (they may also be separated by 
spaces). 




The word search is slightly different. This is 
normally used to locate sixteen-bit address references 
in a machine language program. The Z-80 stores such 
addresses in reverse order, that is, the least 
significant byte first, followed by the most significant 
byte. Thus, the address reference 7F42H would be 
stored in a machine language program as 42 7F. 

The word search routine assumes this to be the 
case, so that when you enter a two-byte value, it will 
automatically reverse them before starting the search. 
Thus, if you wanted to find the two bytes 7F 42 in 
that exact order, you must enter them as 427FH or, 
alternatively, use the byte search mode to look for 
the byte pair 7FH.42H. Note, however, that this will 
not work when you are looking for byte pairs that end 
in 00, for example 3300H. The reason for this is that 
when Super Utility Plus evaluates your ASCII input 
into binary, it will skip over leading zeroes. Thus if 
you were to enter 0033H, it would be evaluated as 
33H. For these cases you must use a BYTE search. 

The word search is specified by entering 16-bit 
values on the prompt line in any valid numeric base, 
although due to the reversal which takes place it is 
probably easier to use hexadecimal (easier for YOU, 
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not the computer). The values should be separated 
from each other by commas or spaces. For example, 

7F42H,CD30H,402DH 

Notice how the bytes are grouped in pairs and each 
pair is separated by commas. This will result in a 
search for the bytes (in hexadecimal) 42 7F 30 CD 2D 
40 in that order. 

If you wish to specify a replacement string, you 
must make sure that the replacement string is the 
same length as or shorter than the search string, or 
the replacement string will be altered (truncated to 
the right length). You could specify an ASCII search 
string and then replace it with a BYTE or word 
string, but it is usually easier to enter the search and 
replacement strings in the same format. 

However, it is also possible to mix different modes 
in a single search or replacement string. That is, 
ASCII strings, byte, and words can all be placed on 
the same line. For example, 

"Tesf^HjgEOH/disk' 

is a perfectly valid string search specification. 

Finally, note that if n @" is the first character of a 
search string, then it will be assumed that the target 
string has been encrypted according to the current 
setting of the decryption routine. The search string 
will be encrypted similarly before the search is 
conducted. If a byte string is given along with "@" 
then the byte string will be created first, then the 
string encrypted. 




Copyright °1983 by Breeze/QSD, Inc. 




USER'S MANUAL 



69 



X. SECTOR SEARCH 

This option is useful in searching out duplicate 
sectors on one or more disks. You will first be 
prompted for the drive, track and sector number of 
the sector that is to form the search template. Then 
you will be asked for the drive, track, and starting 
sector number for the search, followed by the number 
of sectors to search. When the routine completes, it 
will display the total number of matches that it found, 
and their locations on the target disk. 



XI. READ ID ADDRESS MARKS 

This routine will examine a disk and identify the 
track and sector data written on the target disk. This 
will identify any false or non-standard sectors on the 
disk and help you determine just how a disk was 
formatted. You will be prompted for the target drive 
to examine, and the program will start reading track 
and present the information on the display. The 
information will scroll by very rapidly, but can be 
stopped at any time by pressing the spacebar and 
resumed by pressing ENTER. It may also be exited by 
pressing the BREAK key. It will advance up one track 
whenever you press the UP-ARROW and down one 
track when you press the DOWN-ARROW. Additionally, 
you may proceed directly to the highest formatted 
track on the disk by pressing SHIFT-Up arrow, or to 
the lowest track on the disk by pressing SHIFT-Down 
arrow. 




You may also press S to force the routine to read 
only single density sectors, or D to make it read only 
double-density sectors. In addition, when dealing with 
double-sided diskettes, pressing F or ' (apostrophe) will 
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force a read of the front side, while pressing B or " 
(double quote) will cause the back side of the disk to 
be scanned. These keys are active while the display is 
scrolling. Note that these keys will alter the 
configuration settings for the affected drives. 

If the routine encounters an unformatted track, it 
will display the error message "ID ADDRESS READ 
ERROR" or "TRACK NOT FORMATTED." 

Initially, the routine will display seven columns of 
information, as follows: 




8» SUPER-UTILITY t »» VERSION 3.1A 
(CMP) 1983 BREEZE/QSD, INC. - 
SOURCE TRACK HEAD SECTOR LENGTH CRC1 



iQD'« 01 01 

|Q0'» 01 01 

:QD'= 01 01 

:0D'= 01 01 

• :0D'= 01 01 

00'= 01 01 

00'= 01 01 

00'? 01 01 

<Q0'= 01 01 

»0D'= 01 01 

*0Q's 01 01 



00 
00 
00 
00 
00 
00 



00 
00 



06 

02 
04 
17 
07 
03 
16 
12 
14 
16 
01 



01 
01 
01 
01 
01 
01 
01 
01 
01 
01 
01 



15H 
09H 
73H 
8FH 
26H 
EAH 
BCH 
FAH 
9CH 
BCH 
8CH 



» BY* KIM UATT x» 
DALLAS i TEXAS 

CRC2 CKCRC IBM DATA II 
2FH 
EBH 
40H 
CBH 
1EH 
DAH 

FAH YY Y STD 
E4H YY Y STD 
86H YY Y STD 
FAH YY Y STD 
BBH YY Y STD 



The leftmost column is labeled SOURCE. This gives 
you information as to which drive you are reading, 
and the density of the disk in that drive. For 
example, :1D= 01 indicates that the disk in drive 1 is 
double density, and the read/write head is positioned 
over physical track 1. 

The next column is labeled TRACK, and this is the 
track number which is actually recorded on the disk. 
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Some protected disks use non-standard track numbers, 
and if the disk you are reading is one of these, the 
track column would not necessarily agree with the 
actual track number to its left. 

The third column, HEAD, is the head number 
actually recorded on the disk. In double-sided disk 
drives, the head number could indicate which side of 
the disk is being read. 



The fourth column is SECTOR. These are the 
sector numbers as recorded on the disk, and will not 
appear in any special order. Sectors which are 
physically located side by side on a disk will not be 
numbered consecutively. Also, some protected disks 
will assign false sector numbers to prevent them from 
being read by standard operating systems. 

The next column, labeled LENGTH, is a coded 
indication of the amount of data contained in the 
sector. In the IBM convention which TRSDOS and 
most TRSDOS-compatible systems use, a length of 00 
means 128 bytes per sector, and a length of 01 means 
256 bytes per sector. If you are scanning a standard 
disk, this should display 01. In the Model III and 
double-density Model I disks, the only acceptable 
values for LENGTH are 00 through 03, corresponding 
to lengths of 128, 256, 512, and 1024 bytes 
respectively. 

If the disk is not formatted with the IBM 
conventions, then a 00 length byte indicates 1024 
bytes per sector, and a non-zero length byte multiplied 
by 16 will yield the actual number of bytes in the 
sector. By this convention, a non-IBM length byte of 
10H (16 decimal) would be equivalent to an IBM 
length byte of 01. Non-IBM conventions are possible 
on Model I single density disks only, as the 
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double-density controller used by the Model III does 
not use the IBM/NBM indicator. 

Note that the length code indicates the number of 
bytes as recorded on the disk's data fields; it does 
not necessarily mean that there are that many bytes 
actually present in the sector (again, this may be used 
by disk protection schemes to lay a false trail). 

The next two columns are labeled CRC1 and CRC2. 
CRC stands for "Cyclic Redundancy Check," and the 
two bytes are the result of a lightning-fast calculation 
made by the floppy disk controller chip on the sector 
data. When a sector is read back in by the computer, 
the disk controller chip recalculates the CRC's and 
compares them with those recorded on the disk. If the 
bytes recorded on the disk fail to match those 
recalculated by the FDC, it signals an error condition, 
which normally appears on your DOS display as "CRC 
error" or "Parity error during read." 

Planting false CRC bytes is another favorite sport 
of disk protection experts. They will override the 
FDC's calculation and insert their own bytes in place 
of the true CRC's, thus forcing standard operating 
systems to ALWAYS signal an error when attempts are 
made to read their disks. 

If you press the X key while the display is 
scrolling, you will produce an additional three columns 
of information on the screen. The first, immediately to 
the right of the CRC2 column, is labeled CKCRC. This 
is the result of Super Utility Plus's reading of the 
sector, which forces the FDC to report back the CRC 
bytes for the sector. The result is indicated by two 
letters. The letter to the left pertains to the ID 
field's CRC, and the letter to the right pertains to 
the data field CRC. A T indicates that that CRC 
byte on the disk is correct, and an "N" means that 
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there is a discrepancy between the recorded CRC byte 
and the actual byte arrived at by the FDC on the 
basis of the sector data. If the ID field CRC is bad, 
then the data field CRC check will appear as "*" 
since it is impossible to check the data. 

The next column, labeled "IBM," is an indicator of 
whether or not the track was formatted using IBM 
conventions, and will help you in determining the 
meaning of the LENGTH code. Once again, this is 
relevant only for Model I single density disks, as the 
Model III FDC does not use the IBM/NBM byte. 

Finally, the DATA column tells you what data 
address mark was used in formatting. This will display 
STD for standard, DDT for deleted data, RPT for 
"read protected," and UDF for user-defined. As we 
said before, the names do not really mean anything 
and are used simply to differentiate one type of 
address mark from another. 

The Model I floppy disk controller chip is capable 
of reading and writing all four types of data address 
marks, or DAM's. However the double-density 
controller of the Model III can only produce and 
recognize two types of data address marks: STD and 
RPT, even if it is reading or writing a single-density 
disk. 




NOTE: when X is pressed to bring up the 
additional three columns of display, the keyboard will 
tend to become sluggish as it will not be scanned as 
often as when the normal display is scrolling past. 
Thus if you wish to use the arrow keys to move to 
another track, for example, it is necessary to hold 
these keys down for a couple of seconds before the 
desired effect is achieved. Also, in this mode, pressing 
B will lock the scan onto the back side of the disk 
until F is pressed to restore it to the front side. 
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XII. ALTER DATA ADDRESS MARKS 

This routine will allow you to alter the data 
address marks on a diskette to something other than 
the standard marks used by your disk operating 
systems, and may be a good way to produce your own 
"protected" diskettes. You will be prompted for the 
drive, track and starting sector for the alteration, and 
the number of sectors to alter. Finally, the program 
will prompt you for the type of data address mark you 
wish to use. Answer S for standard, R for 
read-protected, D for deleted data, and U for 
user-defined. If you are using a Model III or a Model 
I in double density, please remember that you can 
only use the S and R types. 




Again, care should be taken when using this option, 
as you can wind up with a disk that no operating 
system can read correctly. 
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CHAPTER 3 - PURGE UTILITIES 



Bring up the main menu and press 2. This will 
display the Purge Utilities menu: 



II SUPER-UTILITY t III VERSION 3.1A 
(C)(P) 19B3 BREEZE/QSD. INC. -- 



II BY: KIM UATT 
DALLAS, TEXAS 



Hit 



PURGE UTILITIES 

1 KILL SELECTED FILES 

2 KILL BY CATEGORY 

3 REMOVE SYSTEM FILES 

4 REMOVE PASSUORDS 

5 _ DISK DIRECTORY 

CHOICE? I 



h ZERO UNUSED ENTRIES 

7 ZERO UNUSED GRANS 

B CHANGE DISK NAME 

? CHANGE FILE PARAMS 

10 CHECK DIRECTORY 



The Purge Utilities operate mainly on the directory 
of your system or data diskettes. They provide a very 
fast and very convenient way of killing (and 
recovering!) files from a disk, and even include 
facilities for checking your disk directories for errors, 
and removing all traces of a file from a disk by 
zeroing out the sectors which it occupied. This last is 
very useful in maintaining security. 
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I. KILL SELECTED FILES 

The first choice on the purge menu is KILL 
SELECTED FILES. This will permit you to scan the 
directory of a diskette and "tag" certain files for 
removal. The files are shown on the screen, along 
with a cursor. Active files are shown surrounded by 
left and right arrows (left and right square brackets 
on the Model III) and the non-active file entries 
(killed files) are shown surrounded by graphics blocks. 

Note that the KILL command of TRSDOS removes 
all traces of a file from the directory, so that you 
may not see any non-active file entries on the display. 
Super Utility Plus's purge routines do NOT remove all 
traces of a killed file from the directory in order to 
leave open the possibility of recovering killed files if 
needed. Similarly, other non-RS systems merely tag 
killed files as inactive rather than wiping all traces of 
them completely from a diskette directory. 

You may position the cursor at any filename by 
using the arrow keys. By pressing K while the cursor 
is positioned at a particular file, you "tag" that file 
for killing. You can hit BREAK at any time to abort 
this operation without doing any damage, since the 
purge operation does not actually take place until you 
give the command to write the updated directory back 
onto the disk. 

If you press C instead of K, you will not only kill 
the selected file, but also physically remove all traces 
of its entry from the directory. Pressing the CLEAR 
key at any time will zero out ALL unused directory 
entries. 







mk 
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Pressing N will advance the cursor to the next 
filename in the list and is analogous to using the 
right-arrow to position the cursor. 

By pressing R while the cursor is positioned at a 
non-active file, you can restore that file to the 
directory as an active file. However, you should 
exercise caution when recovering killed files, as other 
files may have overwritten parts of it. There is no 
guarantee that a recovered file is still intact, unless 
you recover it before any other write operations to 
the disk have taken place. 

Pressing the CLEAR key will remove all inactive 
files from the display and zero out their entries in the 
directory which is buffered in memory. When CLEAR 
has been pressed, R will no longer have any effect. 
When the directory is written out to disk, the entries 
of all inactive files will have been zeroed out, making 
future recovery impossible, so be careful. 

If there are more files than can be shown on one 
screen display, you may advance to the next "page" 
by pressing shift up-arrow, or return to a previous 
"page" by pressing shift down-arrow. 

The changes to the directory are maintained in a 
buffer in memory until you press W (for "Write to 
disk"). When you press "W", you will be asked to 
confirm your decision, i.e., whether you really want to 
write the changes back to the disk or not. This will 
give you a chance to change your mind. If you reply 
"Y", the updated directory is written back to the disk. 
If you reply "N", then all changes are cancelled, and 
the original directory on the disk is kept intact. 

You may also input more than one drive number, 
separated by commas or spaces, when initially asked 
for the drive. Pressing A will read in the directory of 
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the next drive. If you have made alterations to the 
current directory, make sure that you have written it 
back to the disk before pressing "A" or all changes 
will be lost. 

Throughout this procedure, BREAK and SHIFT- 
BREAK will remain active and will bring you to the 
PURGE Utilities menu or the main menu, respectively, 
if pressed. 




II. KILL FILES BY CATEGORY 

This option will permit you to kill certain classes 
of files from a disk with ease. You will be prompted 
for a drive, then for the common category. You may 
enter a filename extension, such as /BAS to kill all 
files with the /BAS extension, or /CMD to kill all 
files with the /CMD extension. Do not forget the 
initial slash ("/") if you are specifying an extension. 



WARNING: On a Model I TRSDOS 2.3 disk, and on 
all non-RS system disks, if you specify /SYS, you will 
kill not only all system files, but also the BOOT/SYS 
and DIR/SYS entries in the directory as well! This is 
a very easy way to make a disk TOTALLY unusable! 
If you wish to remove the system files, use the 
wild-card characters option, described in the next 
paragraph, or the "Remove System Files" option. 

You may also use a wild-card option to define a 
common category of files. Entering a letter or a group 
of letters alone will cause all files which start with 
that letter to be killed from the disk. For example, if 
you were to enter B, you would kill the files 
BASIC/CMD, BACKUP/CMD, BULLDOG/BAS, BZ/TXT, 
etc. If you entered BA, however, you would only kill 
the files BASIC/CMD and BACKUP /CMD. 
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Finally, you may kill classes of files based on their 
attributes. You may kill all INVISIBLE files, all 
VISIBLE files, all SYSTEM files, or files with a 
protection level other than (no protection). However, 
see the caution regarding killing system files, above. 

To kill a class of files based on their attributes, 
you must enter a SPACE as the first character when 
prompted for the common category, followed by I for 
invisible files, V for visible files, S for system files, 
or P for files with a protection level other than 0. 
You may enter more than one attribute, separated by 
commas or spaces. 

TRSDOS 1.3 and TRSDOS 2.7DD system files 
cannot be killed with this option, since TRSDOS does 
not log them in the directory in the same fashion as 
normal files. See the next option. 



III. REMOVE SYSTEM FILES 

This option is used to safely kill the system files 
on a diskette. The only input required here is the 
drive number (you may specify more than one, 
separated by spaces or commas). Ail system files 
except for BOOT/SYS and DIR/SYS will be killed. 

Since the Super Utility Plus purge routines do not 
zero out the directory entries of killed files, these 
files may be reinstated as active files using the 
Restore command of KILL SELECTED FILES or the 
disk repair utility (see below). However, this is safe 
ONLY as long as no normal disk writes have been 
done to the disk (EXCEPTION: TRSDOS 1.3 and 
TRSDOS 2.7DD system files cannot be restored). 
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IV. REMOVE ALL PASSWORDS 




This routine will enable you to strip the passwords 
from all files on a disk, including system files which 
are logged in the directory and invisible files. You do 
not have to specify any previously-set password. When 
this routine is selected, you will be prompted for the 
drive numbers containing the diskettes from which 
passwords are to be stripped. The routine will then 
read into memory the directory track of each disk in 
turn, strip the passwords from each file, and change 
the protection level of each file to (full access). 
Other file attributes will not be touched. The 
directory track will then be written back out to the 
disk, and the routine will proceed with the next one, 
if any. 

This routine will set the DISK master password to 
"PASSWORD." File passwords (both access and update) 
will be removed. 



V. DISK DIRECTORY 

This option will, upon input of the drive number(s), 
supply you with the name and date on the disk, the 
number of tracks it was formatted for, the number of 
free granules remaining, and the number of free file 
entries available in the directory. In addition, it will 
display all valid files on the specified diskette(s). The 
display will include protection level (if any), and the 
file attributes (whether it is a SYSTEM file, an 
INVISIBLE file, or a visible file). 



This option can work even if you do not know 
what DOS formatted the disk you wish to look at, by 
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using a "!" in front of the appropriate drive number to 
activate Super Utility Plus's special DOS detect 
routines. Note that this process may take a minute or 
two, and it should not be used on disks which have 
relative sectoring formats (e.g., ND 80 V2 double 
density) or disks which were created by operating 
systems not recognized by Super Utility Plus. 



For example: 



SYSO/SYS 



SIP-7 



means that the file SYSO/SYS is a system file (S), 
has the invisible attribute (I), and has a protection 
level of 7 (no access). The protection levels and their 
meanings are as follows: 



level 

1 
2 
3 
4 
5 
6 
7 



protection 
FULL access 
KILL + 2,4,5,6,7 
RENAME + 4,5,6,7 
Unused 

WRITE + 5,6,7 
READ + 6,7 
EXECUTE + 7 
NO Access 



You will note that each protection level implies all 
the ones below it. You will note also that protection 
level 3 is unused in the standard operating systems. 
You should not assign a protection level of 3 to any 
files because the results would be unpredictable. 
Protection level 7 is assigned to system files and 
means that the user has no access to those files. 







Mm 


Eif^'l- 
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gfy 
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'" '? *" M 



If the disk directory has more entries than can be 
displayed on a single screen page, Super Utility Plus 
will pause at the end of the first screen page. 
Pressing any key will display the next page. If more 
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than one drive was specified at the initial prompt, the 
next drive's directory will be displayed upon 
completion of the previous one. 




VI. ZERO UNUSED ENTRIES 

This option will zero out the directory entries for 
KILLed files. Under most operating systems, a killed 
file is not removed from the disk directory; its entry 
is left in place, but flagged as "inactive." This 
procedure will completely remove the entry of killed 
files from the directory. It requires only the input of 
the disk drives containing disks whose directories are 
to be worked on. 

Since TRSDOS automatically zeroes out a directory 
entry when the KILL command is issued, the 
usefulness of this utility is in cleaning up other 
non-RS DOS directories and directories on which Super 
Utility Plus was used to kill off certain files. 



VII. ZERO UNUSED GRANULES 



This option may be used to remove ALL traces of 
killed files from a disk. This may be desirable when 
security must be maintained at a high level. Input the 
drive number(s), and the routine will zero out all 
unassigned sectors on the target disks. Once this 
utility has been run, no data recovery of any kind is 
possible for killed or inactive files. 

This facility will not touch the diskette directory. 
To remove inactive file entries, you must use the 
ZERO UNUSED ENTRIES option. In most cases (with 
the exception of TRSDOS) when a file is killed the 
data remains on the disk, and so does the file 
directory entry; all that happens is that the file 
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directory entry is flagged as inactive. To remove the 
file directory entry completely, it will be necessary to 
use the ZERO UNUSED ENTRIES procedure. To 
remove all traces of a file from a disk, use ZERO 
UNUSED GRANULES, along with ZERO UNUSED 
ENTRIES. 



VIII. CHANGE DISK NAME 

Some operating systems do not supply an easy 
facility for changing the names or attributes of 
diskettes. This option in Super Utility Plus will permit 
you to do all that. You will be prompted for the drive 
number(s). The directory will be read, and the DISK 
NAME will be displayed and you will be prompted for 
another one. If you merely press ENTER at this point, 
the old name will be retained. 

Next, the creation DATE of the disk will be 
displayed. You may supply a new date, or press 
ENTER to retain the existing one. You will then be 
prompted for a new disk master password. If you hit 
ENTER at this point, the password will be changed to 
"PASSWORD." 

Finally, if you are reading a system disk, you will 
be told if an AUTO command is active. If so, you may 
alter the auto command so that a different program is 
executed on bootup. Pressing ENTER will disable the 
AUTO command on that disk. Note that you cannot 
change the AUTO command on a TRSDOS 6 disk, as it 
is not kept in the directory. 



IX. CHANGE FILE PARAMETERS 




When you select this option, you will be prompted 
for a filename. After you supply one, the directory of 
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the specified disk is searched for that file. If it is 
found, you will then be prompted for the new 
filename. Press ENTER to leave it unchanged. Next, 
you will be asked for the new ACCESS ("user") 
password. Pressing ENTER here will set it to blanks. 
You will then be asked for the new UPDATE ("owner") 
password, and you can either supply one or also just 
press ENTER to set it to blanks. 

The routine will prompt you for the protection 
level next. You must enter a number from to 7 (see 
the table above. Note that 3 is an unused level and 
should not be used). 

Finally, you will be asked to supply the file 
attributes. Enter V if you want the file visible, I if 
you want it invisible, or S to declare it an invisible 
SYSTEM file. Note that any file can be given the 
SYSTEM attribute. At this time the updated 
information will be written back out onto the diskette. 

When copying files to or from a TRSDOS 1.3 
diskette to any other diskette, this routine will come 
in handy for removing the passwords from a specific 
file. TRSDOS 1.3 uses a different password encoding 
algorithm from all other systems, so a file which may 
not have passwords on one system is sure to have 
them when moved to the other! This routine will 
permit the removal of passwords from specific files 
only, if you do not wish to use the Remove All 
Passwords utility. 
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X. CHECK DIRECTORY 



mm 



This option scans the directories on the specified 
drives for errors. You will be advised of the disk 
name, date, number of formatted tracks, number of 
free granules and number of free directory slots. In 
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addition, you will be advised of any errors in the 
directory. Such errors may include granules allocated 
to nonexistent files, HIT table entries which do not 
have corresponding file entries, or vice versa, or 
improperly linked extended directory entries. If any 
such errors occur, you may repair the disk by 
selecting the disk repair utilities of Super Utility Plus 
(see below). 
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CHAPTER 4 - DISK FORMAT Utilities 



Bring up the main menu by pressing SHIFT- 
BREAK. Now press 3 and ENTER. You will be 
presented with the DISK FORMAT Utilities menu: 

I » 

It SUPER-UTILITY + «l VERSION 3. 1A «!t BY: KIM UATT Stt 
(C)(P) 1983 BREEZE/QSD. INC. -- DALLAS, TEXAS 



FORMAT UTILITIES „ 

1 STANDARD FORMAT 

2 " SPECIAL FORMAT 

3 . FORMAT WITHOUT ERASE 

CHOICE? * 



4 BUILD FORMAT TRACK 

5 URITE FORMAT TRACK 
b SOFTUARE BULK ERASE 



« 



This group of routines permits you to format your 
diskettes in a variety of ways. All of the utilities will 
produce formatted tracks that are readable by your 
particular operating system, except for option number 
5, SOFTWARE BULK ERASE, which completely 
removes all data from a disk. 



I. STANDARD FORMAT 




This option will format your target disk using the 
standard format for your operating system. You will be 
prompted for the drive number(s), the NAME for the 
disk, the DATE, and the MASTER PASSWORD to be 
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used on the disk. If you press ENTER to the prompt 
for the name and date, Super Utility Plus will 
automatically supply the name "* Data ** Disk *" 
overlapping in the two (name and date) fields. Pressing 
ENTER in response to the PASSWORD prompt will 
cause "PASSWORD" to be used. 




Finally you will be asked if you wish to use the 
CONFIGURATION for which the system has been set. 
A full discussion of the configuration tables is in 
Chapter 1. Essentially, you may configure Super 
Utility Plus to recognize that certain types of 
diskettes will be found in each drive. For example, 
you may set the configuration table to recognize that 
drive will always contain a MODEL III TRSDOS 
disk, formatted for 40 tracks, while drive 1 will 
always contain a single-density MODEL I DOSPLUS 
disk formatted for 35 tracks, and so on. 

If you answer "Y" to the "Use Configuration ?" 
prompt, Super Utility Plus will scan the data for the 
select the disk in that drive should be formatted. If 
you answer "N\ you will get additional prompts asking 
you to define the format further. 

There is a very easy way to add tracks to a 
diskette using the standard format. For example, if 
you wanted to turn a 35 track disk into a 40-track 
disk, without losing any data that is already on it, 
just place the disk in a disk drive and select standard 
format. Go through all the prompts until you arrive at 
the Use Configuration ? prompt. Now reply "N" and 
press ENTER. 

A further prompt will appear, as follows: 






:d Type.Tks, Dir, St Tk ? 
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where :d is the target drive. Answer the prompts. 
Make sure you give it the proper DOS type. Give "40" 
for the track count, "17" for the directory track and 
"35" for the St Tk (Start track). 

Super Utility Plus will then check the disk for the 
presence of valid data, and ask you whether you wish 
to continue or quit. If you elect to continue with the 
format at this point, Super Utility Plus will proceed to 
format the disk, starting at track 35 and moving up to 
track 39. You will then be prompted whether you want 
to write the directory track and boot sector. This 
prompt will appear only if the specified starting track 
number was other than 0. Reply "N." 

DO NOT REPLY "Y" or a blank directory will be 
written to your disk, rendering previous files on the 
disk inaccessible!! 

To complete the process, check the configuration 
tables and make sure that the configuration for this 
drive correctly reflects the number of formatted 
tracks on the disk. Then go into the REPAIR Utilities 
menu and select the REPAIR GAT TABLE option and 
tell Super Utility Plus to repair the entire sector . 
This will open up the extra tracks on your disk, and 
your 35-track disk will be turned into a functional 40 
track disk with 5 extra tracks of space. 

This presupposes, of course, that your disk drive 
was capable of reading and writing 40 tracks in the 
first place. Also, in order to make use of the added 
space, your DOS must be capable of recognizing that 
it is there and be able to make use of it. Adding new 
tracks to a 35 track with TRSDOS 2.3 will not help 
you a whit, since TRSDOS 2.3 cannot recognize more 
than 35 tracks on a disk. 
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During the format, Super Utility Plus will first scan 
the disk in the target drive. If it sees something 
other than a blank disk, it will immediately display the 
message, 

DRIVE n has DATA! 

where n is the drive you specified for the Format 
operation. If possible, it will also display the disk's 
name and date. You will then be prompted whether 
you want to continue or abort the operation. If you 
elect to continue, the data on the disk will be 
overwritten. A request to abort will put you back in 
the DISK FORMAT Utilities menu. 

There is one special override command which you 
can use when the prompt, "Use Configuration?" is 
displayed. Typing ! will force an immediate format; 
that is, Super Utility Plus will check Track for 
data, but will not check the directory if it does find 
data, and will not prompt you whether it should 
continue or quit, proceeding with the format instead. 
Note than when you are formatting several disks at 
the same time, this lack of prompting will carry over 
to the other drives as well! 




When formatting is completed, you will be asked, 
"Repeat?" You may now take the disk from the target 
drive and insert a fresh one. Then, typing "Y" will 
cause the format operation to be repeated. The same 
information as to DOS type, number of tracks, etc. 
will be used. If you wish to format a disk differently, 
you must hit BREAK and re-select standard format in 
order to specify the new configuration. Typing "N," 
however, will return you to the DISK FORMAT menu. 

If during the format process bad granules are 
encountered, these will be mapped into the track 
lockout table in the GAT sector of the directory. 
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However, if you are formatting a disk which uses a 
relative sector format scheme (i.e, NEWDOS80 V2 
double density or MULTIDOS P-Density) there will not 
be room for mapping bad granules in the GAT table. 
In fact, these types of disks do not use a lockout 
table in the same way as regular disks do. What 
Super Utility Plus will do in such a case is allocate 
the bad granules to prevent their use by the operating 
system. The user should note that this procedure of 
allocating bad sectors may result in subsequent 
Directory check errors. They should NOT be fixed!! 

When using Super Utility Plus to format a disk for 
use under TRSDOS 6 {Model 4), two points should be 
noted. First, a disk formatted by Super Utility Pius is 
assumed to be a data disk in the L3D format and will 
not contain the extensive boot information found on 
disks formatted by TRSDOS 6. Secondly, a disk for- 
matted by Super Utility Plus may under certain cir- 
cumstances cause the TRSDOS 6 backup utility to re- 
ject a mirror-image backup to it, causing it to go ins- 
tead into a backup-reconstruct. Thus, if you format a 
disk under Super Utility Plus and then back up a 
TRSDOS 6 system disk to it under that system, and 
TRSDOS 6 rejects a mirror-image backup, the resulting 
backup disk WILL NOT BOOT. 



II. SPECIAL FORMAT 

This routine allows you to construct one or more 
tracks sector by sector, with a variety of formatting 
options. You can control the contents of the 
identification fields for each sector, the data address 
mark for each sector, and even the placement of false 
CRC bytes. In addition, you can construct a track 
with a mixture of single and double density sectors 
(providing, of course, that your computer is equipped 
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with double-density). This routine may be used for 
constructing specially-formatted "protected diskettes." 

When you enter this routine, you will first be 
asked how many tracks you want to create. After you 
have entered a number, you will be shown a line that 
looks like this: 

TRACK 00 rSINGLE 00 DOUBLE 00 

with a prompt line beneath it. This line indicates 
which physical track and sector you are working on, 
and whether the sector is single or double density. 
The position of the colon (:) indicates which it is. If 
you are going to mix densities within a track, you 
must construct all your single-density sectors first 
before going on to the double-density sectors. Once 
you start on a double-density sector there is no going 
back to single till the next track. 

To construct an individual sector, you must supply 
the routine with the necessary information for that 
sector. These are: 




Tnn TRACK number 

Hnn HEAD number 

Snn SECTOR number 

Lnn SECTOR length 

IorN IBM or Non-IBM length 

convention 

Ax DATA ADDRESS MARK type 

Cy CRC type (true or false) 



T, H, S, and L may be followed by a number, or the 
letter R. That is, you may specify which track, head, 
and sector number, and sector length, is to be 
associated with this physical sector. If you specify R 
instead, you will generate random numbers for the 
particular parameter you give R to. Any parameter not 
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specified will default to certain values. Track number 
will default to the physical track number. Sector will 
default to 0. Head number defaults to 0, length 
defaults to 1. Remember that the track and sector 
numbers do not have to correspond with the physical 
track and sector numbers! In fact, each sector on a 
track may have a different track and sector number 
associated with it! HEAD refers to a byte which 
indicates which side of the disk this sector is on 
(Head indicates the first side, Head 1 indicates the 
second side. You can use anything.). 

The L parameter is a coded value which indicates 
the number of data bytes in this sector. How it is 
evaluated depends on whether you are writing a sector 
using the IBM convention or not, which is specified 
by the parameter I or N. IBM is the default. Using 
IBM conventions, would mean a 128-byte sector, 1 
indicates 256 bytes, 2 indicates 512 bytes, and so on. 
On a Model I, single or double-density sector you may 
specify IBM or non-IBM (NBM) conventions. The 
default is IBM in all cases. When creating NBM 
sectors on a Model I, when you switch from to the 
next track, the IBM/NBM bit is not reset to IBM. 

The IBM/NBM bit is not used on the Model III or 
double-density Model I. 

The type of data address mark to be used for this 
sector only may be specified with the letter A 
followed by one of four identifiers: S for standard 
DAMs, R for read-protected, D for deleted data, and 
U for user defined. For example, a read-protected data 
address marks would be specified by AR. Note that on 
double-density Model I TRSDOS and Model III 
TRSDOS, only the S and R types are available. 

The condition of the CRC bytes can also be 
controlled by entering the letter C followed by a 



Copyright e 1983 by Breeze/QSD, Inc. 



94 



Super Utility Plus 3.2 



number from to 3. The numbers correspond to 
certain conditions, given below: 

Normal ID and DATA CRCs (default) 

1 Correct ID field CRC, error on data CRC 

2 Correct ID field CRC, no data CRC or 
sector header written 

3 CRC error on ID field, no sector header or 
data CRC written 

Thus, to create one sector, a typical command line 
might be: 

T21 HO SEOH LI AR CO 




This line creates a single sector with the following 
information: The sector has a track number of 21, has 
a head ID of 0, a sector number of EOH, an IBM-type 
length byte of 1, read-protected data address marks, 
and normal CRCs. The next sector might be created 
using TFFH HI S8FH L0 AD CI which creates a 
sector with a track number of FFH, and has a head id 
of 1, a sector number of 8FH, "deleted data" address 
marks, a correct ID field CRC but false data CRCs. 

To switch from single to double density, enter a D 
on the prompt line as the first character of your 
sector specifications. This indicates to the routine 
that this sector and all following sectors created are 
to be in double-density (D needs to be entered only 
once). Remember that you cannot return to producing 
single-density sectors once you have moved to double- 
density until you move to the next track. 

Pressing ENTER on a blank prompt line will 
terminate all processing for the current track. Your 
special format track will now be residing in memory. 
You will now be presented with a new prompt asking 
if you wish to examine the track before writing it out 
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to disk. If you reply "N", then the tracks 
written out to the destination disk. 



will be 



If you elect to examine the track, you will be 
placed in the DISPLAY MEMORY mode and the track 
buffer will be displayed. You can now load up its 
sectors with data, and make any alterations you wish. 
Pressing the spacebar will write one track to the disk 
and return to displaying the NEXT track in the 
buffer. Thus each press of the spacebar will write one 
track out. Pressing CLEAR will write all the sectors 
out to the destination disk without returning to the 
display mode. The track will be written to the disk, 
and the program will advance you to the next physical 
track. As usual, pressing BREAK and shift-BREAK will 
terminate the procedure and return you to the 
FORMAT and main menus, respectively. 



While in the track display mode, all DISPLAY 
MEMORY paging and modification controls are active 
as usual (except for the CLEAR key). See the 
MEMORY UTILITIES chapter for more information. 



III. FORMAT WITHOUT ERASE 




This routine will permit you to reformat a disk 
without losing any readable data that was already on 
it, and is very useful for revitalizing disks which have 
been lying around for a long period of time. It is also 
a good way to repair "Sector not found" and "Data 
CRC" errors. You will be prompted for the drive 
number(s). If you specify a "!" at the initial prompt 
for the drive numbers Super Utility Plus will scan the 
disk to see how it is formatted, then proceed to 
reformat it without destroying any data. 

When you press ENTER to start the routine, Super 
Utility Plus will scan each track, reading each sector 
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into a buffer in memory. It will then reformat that 
track, and write the data back out to it. 

If during this process Super Utility Plus encounters 
a bad sector, it will present you with the R>etry, 
S>kip, Oontinuous, N>onstop or Q>uit ? menu. If you 
are trying to recover a bad disk through this method, 
use R, C or N as heavily as possible. Don't skip a bad 
sector at once. If Super Utility Plus can read the 
sector at all, it will rewrite it back out with the 
correct format, thereby repairing the error. So give 
the program a chance. It may take several minutes, 
but if the sector can be read at all, Super Utility 
Plus will do it -- and recover your data. 




IV. BUILD FORMAT TRACK/WRITE FORMAT TRACK 



These two routines will permit you to create 
specific tracks and write them out to disk at specific 
locations. This may be useful for saving a glitched 
diskette, by replacing the damaged tracks with new 
ones. The data on the damaged track(s) will be lost, 
of course, but the rest of the disk will be intact. 

The BUILD FORMAT TRACK procedure differs 
from the SPECIAL FORMAT routine in that it only 
constructs standard format tracks and requires no 
input from the user other than the DOS type and 
track number. When you select the BUILD FORMAT 
TRACK option, you will first be asked to specify the 
DOS type. Reply with one of the valid DOS type 
identifiers to create the appropriate track. You will 
then be asked what track number to assign to it. This 
should be the track number where you intend to write 
it out to the disk. 

Super Utility Plus will then create the track in 
memory, and display the message, "Press <ENTER> to 
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view the track at nnnnH". By pressing ENTER, you 
will be able to view the track buffer in memory. Press 
BREAK to return to the DISK FORMAT Utilities 
menu. 

Once you have built a format track in memory, you 
may write it out to disk by selecting WRITE FORMAT 
TRACK and specifying the track number. The track in 
the memory buffer will be placed on the disk. Note 
that you can build a track in memory with one track 
number, but write it out to another location on the 
disk. This is entirely possible, but not recommended. 



V. SOFTWARE BULK ERASE 

This utility will completely remove all data from a 
target disk and can be used to clean up a disk in 
place of a bulk eraser or magnet. If you have 
problems with the DOS rejecting a backup or a format 
due to "different pack IDs," this routine will solve 
that problem. You will be asked which drives are to 
be bulk-erased. Make sure they contain the proper 
disks! When you press ENTER, the disk will be 
overwritten completely with 00 bytes, removing all 
traces of formatting and data. Take as much care in 
using this routine as you would in using a bulk eraser, 
since there is no recovery possible . 
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CHAPTER 5 - BACKUP UTILITIES 



There are two routines to this group: Standard 
Backup and Special Backup. Standard Backup is used 
on those disks which can be identified using one of 
the valid DOS specifiers. Special Backup is used for 
all others. 



I. STANDARD BACKUP 




'fgmkUii 



Super Utility Plus has a very fast backup routine 
which can be used in place of the standard 
BACKUP/CMD of your operating system(s). It will 
work on a one-drive system as well as on a multi-drive 
system. Additionally, more than one destination drive 
can be specified, in which case, the source disk will 
be backed up to the other drives one at a time. 

When selecting this procedure, you will first be 
asked for the source drive. Enter the drive number 
which contains your source disk. Do not enter more 
than one source drive. You will then be asked for the 
destination drives. You may enter more than one, 
separated by commas, or spaces. 

You will next be asked if you wish to format the 
destination drives first. You may reply "Y" to format, 
"N" if the disk is already formatted, T to force a 
format even if the disk has data, or "*" to format and 
skip the verification cycle. If you type "Y", "!", or 
"*", each destination drive will be formatted. To avoid 
any problems, make sure you have configured both the 
source drive and the destination drive(s) with the same 
DOS specifier. While it is possible to back up one 
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disk onto another with a different DOS specifier, this 
is not recommended (see below). 

Immediately after formatting, a full disk backup 
will be performed. Unlike the backup procedure of 
some systems, this backup will not skip any empty 
tracks. Nonetheless it will still be quite fast. 

If you do not wish to reformat the destination 
disks, merely reply "N" and the backup will proceed. 
The destination disks must of course have previously 
been formatted. 

After the source disk has been backed up to all 

the destination drives, you will be asked "Repeat?" 

Reply "Y" if you wish to do more backups, or "N" to 
return to the menu. 




If you backup one disk to another with a higher 
track count, as for example a 35-track disk to a 
40-track disk, the backup disk will still reflect the 
availability of 40 tracks rather than 35 as would 
result from using other Backup programs. 

When using the backup procedure to copy disks, 
the source and destination diskettes must have a 
compatible configuration. For example, backing up a 
single-sided disk onto a drive configured as double 
sided is illegal , and will result in an error. 

Also, the drives must be of compatible type. 
Attempting to back up a double-sided disk placed in a 
single-sided drive will result in severe errors. 
Similarly, backing up a TRSDOS 1.3 disk onto a drive 
configured for NEWDOS/80 V.2 double-density or any 
other disk to a drive configured for a different DOS 
will result in a badly messed-up disk. Remember that 
by definition BACKUP implies the creation of an 
EXACT copy of the source disk. 
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The BACKUP utility is the easiest way to recover 
the data from a disk with bad sectors. As each bad 
sector is encountered, you will be presented with the 
R>etry, S>kip, Continuous, N>onstop or Q>uit prompt. 
Use R, N or C whenever this happens. If the sector 
can be read at all, it will be copied over intact to 
the backup disk, thereby recovering the data. Even if 
not all of the sectors can be copied, you will still 
wind up with a usable {that is, totally readable) disk 
from which you can copy off as much useful data as 
you can. In addition, the original disk, bad sectors and 
all, will still be available for another try. 



II. SPECIAL BACKUP 




The special backup routine is intended for disks 
that do not conform to any of the valid DOS 
specifiers. This are usually disks with damaged 
formatting information, or a disk deliberately 
formatted in a non-standard manner. This routine 
requires the input of the number of physical tracks on 
the target disk (or a reasonable estimate thereof). 
When ENTER is pressed, the program will begin 
scanning the source disk and building a table in 
memory of its formatting characteristics. This will 
take several minutes. If the routine is able to 
successfully scan the entire disk, it will then ask you 
whether you want to view the format track buffer in 
memory. At this point, Super Utility Plus has 
constructed an image of the source disk's formatted 
tracks in memory, and you can reply n Y" to display 
them (in DISPLAY MEMORY mode) to examine their 
structure. Note that these are bare formatted tracks, 
with no data in the sectors. Pressing the spacebar will 
write the current track to the destination disk and 
return to displaying the NEXT track. Pressing CLEAR 
will write the buffer to the destination disk without 
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returning to the viewing mode. While in the viewing 
mode, all DISPLAY MEMORY paging and modification 
controls (except for CLEAR, which has a different 
function) are active. See the MEMORY UTILITIES 
chapter for more information. 




If you do not wish to view the formatted tracks in 
memory, simply reply "N" in response to the prompt, 
and the tracks will be written out to the destination 
disk. After the destination disk has been formatted, 
then the data will be copied from the source disk 
onto the destination disk. 

This routine is intended as a last-ditch recovery 
procedure for damaged disks which the standard repair 
methods cannot handle. It can also handle many disks 
formatted in a non-standard manner, however there is 
no guarantee made that the Special Backup routine 
will be able to duplicate every disk ever produced 
with a special format. In fact, there exist particular 
formats which by their very nature cannot be easily 
duplicated, or duplicated only partially, without intro- 
ducing unwanted changes into their structure. There 
are also certain types of formats which, while they 
can be duplicated, cannot have any data written to 
them without destroying their special characteristics. 
If you encounter a special-format disk which cannot 
be copied with this routine, please contact your dealer 
or supplier to obtain a copy. Most dealers who sell 
protected disks have a reasonable backup policy and 
will allow you to purchase a copy at a nominal fee. 
Please do not call us for updates to the SPECIAL 
BACKUP routine. 
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CHAPTER 6 - REPAIR UTILITIES 



Selection of this group from the main menu will 
produce the following menu display: 



I i 

« SUPER-UTILITY t H VERSION 3.1A *» BY: KIM UATT ik 
(C)(P) 1983 BREEZE/QSD. INC. - DALLAS, TEXAS 



REPAIR UTILITIES 



1 REPAIR GAT SECTOR 

2 REPAIR HIT SECTOR 

3 . REPAIR BOOT SECTOR 

4 READ-PROTECT DIRECTORY 

5 UN-READ PROTECT DIR 



CHOICE? • 



L . RECOVER KILLED FILES 

7 MOVE DIRECTORY 

8 . DISPLAY DIRECTORY 

9 . CHECK DIRECTORY 

10 CLEAR UNUSED ENTRIES 



fT*!*^ 




These utilities are designed to restore disks which 
might be unusable or contain garbled data to a usable 
condition, if it is at all possible. Many times a disk 
becomes unreadable because of some damage to the 
directory. If the damage is not too extensive, the 
REPAIR utilities will be able to fix it. However, the 
disk itself must be readable, i.e., it must not contain 
any format errors or CRC errors which will prevent 
Super Utility Plus from reading it. If necessary, use 
FORMAT WITHOUT ERASE or the backup procedure 
described in the previous chapter to make sure the 
disk is readable. Note also that the REPAIR utilities 
assume that there is no data loss or damage in 
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the third and following sectors of the directory, where 
the file entries are maintained. If there is data loss 
in this area it may not be possible to fully recover a 
damaged directory. 




The REPAIR utilities also contain routines which 
will allow you to check on the condition of a 
directory, recover any files killed by the PURGE 
utility of Super Utility Plus, move the directory track 
from one location to another on the disk, or clear the 
unused directory entries by setting them to zero. 



I. REPAIR GAT SECTOR 

The GAT (for Granule Allocation Table) sector of a 
diskette directory is where the operating system keeps 
track of which granules have been assigned to files, 
which are available for use, and which have been 
locked out for one reason or another. An error in the 
GAT can result in files being allocated disk space 
which already belong to other files, thus resulting in 
DATA loss. This is the kind of creeping error which 
can eventually render an entire disk worthless. 



The GAT REPAIR option will permit you to repair 
a bad GAT table. Upon entering this option, you will 
be asked for the drive number containing the disk to 
be repaired. You may enter more than one drive 
number if you are repairing several disks. You will 
then be asked whether you want the GAT Table only 
(the first 96 bytes), or the entire sector, to be 
repaired. 

If the disk name and date are unreadable, select 
the ALL option to rebuild it. Otherwise, if the GAT 
table alone is damaged, select GAT Table repair only. 
This will allow you to retain the original disk name, 



Copyright °1983 by Breeze/QSD, Inc. 





USER'S MANUAL 



105 



date, password, and any active auto -command. Super 
Utility Plus will then proceed to rebuild the granule 
allocation table of the target disk(s) by reading the 
allocation information for each file in the rest of the 
directory. 



II. REPAIR HIT SECTOR 

Each filespec in a directory is "hashed" by the 
operating system into a one-byte code and entered 
into the HASH INDEX TABLE sector, in a position 
which defines the file's actual position in following 
directory sectors. This permits the operating system to 
find filespecs in the directory very quickly. Errors 
which may occur here are HIT codes assigned to 
nonexistent files, invalid HIT codes, etc. Or the 
sector itself may have been damaged so that part or 
all of it may have been turned into garbage. 

If a directory check reveals errors in the HIT 
sector, you may use this option to repair it. The only 
required input is the drive number containing the 
damaged disk (you may enter more than one drive 
number). When you press ENTER, Super Utility Plus 
will proceed to reconstruct the entire HIT table. 

TRSDOS 1.3 codes the SYSTEM files in the last 
32 bytes of the HIT table, and TRSDOS 2.7DD in the 
last 48 bytes. Because of the fact that they do not 
have any standard directory entries, these bytes will 
be left untouched by Super Utility Plus during a HIT 
repair, since without standard entries, it is not 
possible to reconstruct a HIT entry. If these bytes 
have been corrupted, you must use the ZAP utility to 
effect repairs. If the bytes look obviously invalid to 
you, enter FF in all 32 slots (48 for TRSDOS 2.7DD). 



L|. , .Ml 
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III. REPAIR BOOT SECTOR 



Super Utility Plus 3.2 




If a system disk will not boot, the chances are 
that the boot sector has been damaged. This sector 
contains code which loads the rest of the operating 
system into memory, so if this sector is corrupt, the 
rest of the DOS will not load. If this is the case, you 
can effect a repair of the boot sector by selecting 
this option. You will be prompted for the drive number 
containing the disk with the damaged boot. When you 
hit ENTER, Super Utility Plus will write the new boot 
routine into this sector. 

Super Utility Plus contains three different boot 
routines, which are intended for use on TRSDOS 2.3, 
1.3, or 2.7DD disks ONLY , and which Super Utility 
Plus can use to replace a damaged boot sector. These 
boots are for a single density disk, a double-density 
disk with a single density Track 0, and for a pure 
double-density disk. The one which Super Utility Plus 
writes to your disk will depend on the DOS type 
assigned to that drive in the Configuration table. The 
boots are not the same as the standard boots, but 
very fast routines which check each byte of the the 
resident operating system module (SYSO) as it loads it 
into memory to ensure that the load is a good one. 

This repair option does not log the boot in the 
directory (the operating system will already have it 
logged in anyway). All it does is write the new 
routine into the sector formerly occupied by the 
damaged one. 



To repair the boot sector on a any other DOS than 
those listed above, first make sure that the boot 
track is readable (does not contain any CRC errors, 
etc.). Then take a GOOD disk and copy the boot 
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sectors from it onto the bad disk using the COPY 
SECTORS procedure in the ZAP Utilities. 



IV. READ-PROTECT DIRECTORY 



If you try to boot a system diskette, and the disk 
drive seems to have difficulty in finding a file, or if 
you try to read a file on a data diskette and the 
drive seems to be hunting all over the diskette, or if 
you try to display a directory and the disk drives 
grind along for several minutes, the chances are that 
all or part of the directory was re-written using the 
wrong DATA ADDRESS MARK {Note: this can also 
happen if you try to read a single-density Model I 
TRSDOS diskette on a Model III machine). The 
directory track of a diskette has a data address mark 
(see chapter 2) which is different from ail the other 
tracks, and is used by the operating system to 
identify its location. 

Whenever the DOS tries to read a directory and 
finds that some or all of the directory sectors do not 
have the correct data address mark, it will hunt all 
over the disk for a track that has the proper DAMs. 
It will not find it, and so your drive sounds like its 
head keeps moving back and forth (which is exactly 
what is happening). 

The term "read-protecting a directory" is a 
misnomer and refers to the process of writing a 
directory track with the correct data address mark 
which can be recognized by the operating system. It 
does NOT mean changing the directory so that it 
cannot be read at all. Unfortunately, the term stuck. 




When this option is selected, you will be prompted 
for the drive number(s) containing the target disks. 
When you press ENTER Super Utility Plus will read 
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the directory track, then write it back out with the 
correct data address marks. If it cannot find the 
directory you will be asked to specify its track 
location and length (i.e., number of sectors in the 
track). You may enter the track number where the 
directory is located followed by its length, or press 
ENTER to default to the directory track number and 
track length in the configuration table. 




If you recall the discussion of data address marks 
in chapter 2, you will realize that if you try to read 
a MODEL I single-density TRSDOS disk in a Model III 
machine, your Model III (or MAX-80) will not be able 
to find the directory track. The reason is that the 
data address mark used by Model I TRSDOS (and 
other similar systems) is one that the Model III 
hardware cannot recognize. If this problem does not 
occur with another operating system, it is most likely 
because that system uses a data address mark for the 
directory track that both the Model I and Model III 
can recognize. 

This has other implications. Super Utility Plus will 
adapt itself to whatever machine it is running on. If 
you attempt to read-protect a TRSDOS 2.3 disk 
directory on a Model III machine, you will write the 
WRONG data address marks on the Model I disk! So 
even after you thought you had fixed the problem, 
now your TRSDOS 2.3 will be unable to locate the 
directory track! 



If you are going to use this option, therefore, 
make sure that you are using it on the RIGHT 
machine. Do not attempt to read-protect a TRSDOS 
2.3 directory track on a Model III computer, and vice 
versa. This restriction may not apply to other 
operating systems, however. 
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V. UN-READ PROTECT DIRECTORY 

This option takes a directory track and rewrites it 
using standard data address marks (or RPT data 
address marks, if the disk is Model III TRSDOS). The 
only input required is the drive number. You may want 
to use this routine if you are developing a protected 
disk with a directory that you do not want any 
standard operating system to be able to read. 



VI. RECOVER KILLED FILES 

This routine will allow you to recover files 
previously killed using Super Utility Plus's PURGE 
utilities. You cannot use it to recover files killed with 
the standard TRSDOS "KILL" command, as the entire 
directory entry is zeroed out when a file is "KILL"ed 
(you may, however, use it to recover a file KILLed 
under other non-RS operating systems). 

Remember that recovering a killed file is a chancy 
affair IF you have performed any disk writes since 
the time you killed the file. In the first place, you 
may introduce errors into the directory's GAT (granule 
allocation table). Secondly, the file you recover may 
have had parts of it overwritten by subsequent files. 
So be careful when using this routine. 




■« 



You will first be prompted for the drive number or 
numbers. Upon hitting ENTER, Super Utility Plus will 
display the disk name, date, number of formatted 
tracks, and number of free granules and free directory 
slots on the disk. Press ENTER again. You will now 
be shown a list of all VALID and NON-VALID (i.e., 
killed) files in the directory of the target disk. All 
valid files will be surrounded by right and left arrows 
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(right and left square brackets on the Model III). 
Non-valid files will be surrounded by solid graphics 
blocks. 

To recover a killed file, move the cursor to the 
file that you wish to restore, using the arrow keys. 
Press R and you will see the graphics blocks replaced 
by right and left arrows (or brackets), indicating that 
the file is now a valid directory entry. 

When you have recovered all the files you want to, 
press W to write the updated directory back onto the 
disk. You will be asked to confirm your decision. 
Press "Y" to confirm and write the directory, or press 
"N" to abort the procedure. Pressing A will abort the 
process and proceed to the next drive if more than 
one was specified, so if you have made any changes, 
make sure you write the directory back out to disk 
before using A to proceed to the next target drive. 

If there are more files than can be displayed on 
the screen at one time, you can press SHIFT and UP 
ARROW to go the next display page, or SHIFT and 
DOWN ARROW to move to the previous page. 




VII. MOVE DIRECTORY 

This option will move the directory track to any 
other track on the target disk as long as that track 
is not already allocated to another file. You will be 
prompted for the drive number(s) containing the target 
disks, and the track number where you want the 
directory moved. If the track you selected is already 
allocated (either fully or partially), Super Utility Plus 
will display a message to that effect and ask you to 
select another track. If you press ENTER without 
giving it a new location, Super Utility Plus will 
display the available tracks where the directory can 
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be safely moved. Upon entering the track number and 
pressing ENTER the directory track will be moved, 
and the boot sector changed so that it now points to 
the new updated directory (the position of the 
directory is coded in the second or third byte of the 
boot sector depending on the operating system 
involved). The old location will be rewritten with the 
correct DAMs. Also, on TRSDOS 2.3 and all other 
non-RS disks, the DIR/SYS entry in the directory will 
be updated to reflect the directory's new location. 



If you wish to abort this routine, BREAK or 
SHIFT-BREAK will always take you back to the 
menus. 



VIII. DISPLAY DIRECTORY 

This option requires only the drive number or 
numbers containing the disks whose directories you 
wish to view. It will give you a full screen display of 
all active files on the disk(s), along with the 
attributes and protection levels of each file 
(protection level is not displayed). In addition, the 
disk name, date, number of free granules and free 
space in K (kilobytes, units of 1024 bytes), and 
number of free directory slots are also displayed. 

If you view a TRSDOS 1.3 or 2.7DD directory, you 
will not see any system file names displayed. As was 
discussed above, TRSDOS 1.3 and 2.7DD does not 
code the system files in the directory in a normal 
manner. They will therefore be displayed as numbers, 
e.g. 

00-01-02-03-04-05-06-07-08-09-10-11-12-13-14 




indicating which of the relative system files are 
currently active (not killed) in the directory. 
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IX. CHECK DIRECTORY 

This option is designed to perform a very thorough 
check of the directory on the target disk. You will be 
prompted for the drive number. When you hit ENTER, 
the routine will scan the directory. It will then 
display the disk name, date, the number of free 
granules and the number of free directory slots. Any 
errors encountered will then be displayed. 



If the routine reports any GAT or HIT errors, you 
may use the GAT REPAIR or HIT REPAIR options to 
automatically repair the directory. 



X. CLEAR UNUSED ENTRIES 

This option will permit you to clean up a diskette 
directory by completely erasing the entries of any 
non-active files. Normally the entries of non-active 
files are left in the directory by systems other than 
TRSDOS 1.3 and 2.7DD and the Super Utility Plus 
purge routines to leave available the possibility of 
future recovery. If you use this routine, of course, no 
future recovery will be possible. 

You will normally not need to use this directory to 
clean up files where TRSDOS 1.3 or 2.7DD did the 
killing, since these TRSDOS systems remove the 
entries of non-active files anyway. 
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This option requires only the input of the drive 
number(s) containing the target disk(s). You may enter 
more than one drive number, and the directories will 
be scanned and cleaned one by one. 
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CHAPTER 7 - TAPE UTILITIES 



The TAPE UTILITIES of Super Utility Plus give 
you the following procedures: (Note: Tape Utilities are 
not available in the MAX-80 version of Super Utility 
Plus since that computer does not have any cassette 
port) 



mm SUPER-UTILITY + mm VERSION 3.1A MM BY* KIM UATT mm 
(CMP) 1983 BREEZE/QSD, INC. -- DALLAS, TEXAS 



TAPE UTILITIES 



1 READ TAPE 

2 URITE TAPE 



3 _ VERIFY TAPE 

4 COPY TAPE 



CHOICE? * 




It should be noted at the outset that these 
utilities do not provide any disk-to-tape or tape-to-disk 
interface. The TAPE UTILITIES are intended for 
tape-to-tape procedures. Secondly, the user should 
remember that only 500 baud cassette operations are 
supported . The higher 1500 baud tape rate of the 
Model III is not supported by Super Utility Plus. 
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I. READ TAPE 



Super Utility Plus 3.2 




If you are using a Model I this routine will prompt 
you for the deck number to read from and input the 
data from the specified deck, or from the regular tape 
port on a Model III. When this option is selected, you 
will see the message: 

<KEY> to begin:_ 

Press the PLAY button on your cassette recorder, 
then press ENTER. The routine will begin reading the 
tape, and the message "Looking for sync byte" will 
appear. You may abort the operation at any time by 
pressing the CLEAR key. Once the routine picks up 
the sync byte it will start reading the data into a 
memory buffer. The data will be displayed on the 
screen. The actual ASCII character will appear on the 
top row, and below it, reading vertically, the ASCII 
HEX value of that character. 

The read operation will continue until the CLEAR 
key is pressed, or the buffer fills. When the read is 
completed, you will be told how many bytes were read 
in from the tape and where they are stored. You will 
also be given the checksum calculated from the data. 
Pressing ENTER at this point will take you into 
MEMORY DISPLAY mode, and you will be able to 
view the data that was read in. See the next chapter 
for details on the memory display routine. 



The tape read operation will abort when the buffer 
fills up. You will be told how many bytes were read 
in up to the time of the abort, and then given a 
chance to display the data and examine it. 
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II. WRITE TAPE 

This procedure will allow you to write a tape using 
the data that is in the holding buffer. If there is no 
data in the buffer, you will be informed. Then you 
will be asked for a starting and ending address. Note 
that you may specify an address anywhere in memory, 
the ROM space included, and write that out to tape. 
If you are using a Model I, you will be prompted to 
specify which tape deck (1 or 2) to use. When you 
press ENTER to begin the write operation, the routine 
will write the leader and sync byte, and then the 
data. The data is displayed on the screen as it is 
written. Again, you may abort the operation at any 
time by pressing CLEAR. 



Note that this routine will write out the data 
exactly as it finds it. No conversion to any particular 
format will be done; the routine assumes that the data 
is already in the proper format. 

At the completion of the tape write the routine 
will display the number of bytes written, the starting 
and ending address, and a two-byte checksum of the 
data. Pressing ENTER at this point will bring you 
back to the TAPE UTILITIES menu. 



III. VERIFY TAPE 




Selection of this procedure assumes that the data 
you want to verify has previously been read into the 
holding buffer with READ TAPE. Reposition the tape 
to the start of the file, press the PLAY key on the 
appropriate recorder, and press the ENTER key on the 
keyboard. The program will begin reading the tape 
again and will compare the data with whatever is in 
the holding buffer. The data will be displayed as it is 
read in, and discrepancies will be indicated with an 
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asterisk above the offending byte. At the end of the 
verification process, you will be told how many errors 
were encountered during verification. 




Note that the routine has no way of knowing 
WHICH of the byte pairs compared was in error -- the 
byte read into the holding buffer the first time, or 
the byte read in during the verification. It will simply 
report the discrepancies. 



IV. TAPE COPY 

This routine will allow you to back up a tape. You 
will need two tape recorders. The cable coming from 
the cassette port of the computer terminates in three 
jacks. Insert the black jack into the EAR plug of the 
source recorder. Insert the grey miniature jack into 
the MIC input of the destination recorder , and the 
grey subminiature jack into the motor control of the 
destination recorder also. You may need to use patch 
cords if the wires are not long enough. 

Select the copy tape routine. Specify the SOURCE 
deck. Press ENTER. Press the PLAY button of the 
source recorder, and the PLAY and REC button of the 
destination recorder. A graphic block will appear on 
the screen. As soon as valid data is picked up, this 
block will begin flashing. 



The routine will read each bit from the source 
recorder, clean it up, and write it immediately to the 
destination recorder without storing it in memory. This 
should produce a byte-for-byte copy of the original 
tape. The routine will have to be manually terminated 
by pressing CLEAR. 
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CHAPTER 8 - MEMORY UTILITIES 



The MEMORY Utilities of Super Utility Plus permit 
you to view and manipulate memory in a variety of 
ways. Many of these routines are very similar to the 
ZAP utilities, as can be seen from the menu below: 



II SUPER-UTILITY t II VERSION 3. 
(C)(P) 1983 BREEZE/QSD, INC. 



1A II BY: KIM UATT II 
-- DALLAS, TEXAS 



MEMORY UTILITIES 

1 . DISPLAY MEMORY 

2 _ MOVE MEMORY 

3 _ EXCHANGE MEMORY 

4 COMPARE MEMORY 

5 _ FILL MEMORY 

t> REVERSE MEMORY 

7 TEST MEMORY 

8 . JUMP TO MEMORY 

CHOICE? » 



9 


STRING SEARCH 


10 


INPUT BYTE FROM PORT 


11 


OUTPUT BYTE TO PORT 


12 


MEMORY TO SECTORS 


13 


. SECTORS TO MEMORY 


14 


MEMORY TO TRACK 


15 


TRACK TO MEMORY 



In addition, the memory utilities permit you to read 
and write to any I/O port from to 255. You may 
also perform a direct memory-to-disk or disk-to-memory 
transfer. 




Great care should be taken when modifying memory 
in any of the ways made available to you from this 
menu. Unlike the modification routines in the ZAP 
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utilities, changes to memory are not buffered and take 
effect immediately on entry. 




I. DISPLAY MEMORY 

This option requires input of the starting memory 
address that you want displayed. You may enter the 
address in any of the four number bases that Super 
Utility Plus will accept (Hexadecimal, Decimal, Octal, 
or Binary). The default base is Decimal. To enter a 
hexadecimal number, you must append "H" to the 
number; to enter an octal value, append (the letter 
"0" -- not zero!!!) or Q and to enter a binary number, 
append B to the number. 

The display is very similar to the ZAP display, 
with the exception that the first column of 
information is empty, and the actual addresses (in hex) 
are displayed in the second column, adjacent to the 
actual data. The data is displayed in blocks of 256 
bytes each. You can look on this display as a window 
into the TRS-80's memory which can be moved around 
so as to present different views of the RAM or ROM 
"landscape." 

Using the arrow keys, you can scroll through 
memory. By pressing the right or left arrows, you can 
move the display window one byte at a time in either 
direction. Pressing SHIFT-right arrow or SHIFT-left 
arrow will advance or decrease the display 256 bytes 
at a time. 

Pressing up-arrow or down arrow will also move the 
display window 256 bytes at a time in either direction. 
However, pressing SHIFT-up arrow has a different 
effect; this will cause the highest 256-byte block of 
memory available in the computer to be displayed. 
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Similarly, pressing SHIFT-down arrow will display the 
lowest 256-byte block of memory. 

Pressing the CLEAR key will cause Super Utility 
Pius to prompt for a new memory address to display. 

Pressing M will put you in Modification Mode. As 
in the ZAP utility's modification mode, you can select 
your input base by pressing H (hexadecimal), O or Q 
(octal), D (decimal), B (binary) or A (ASCII) before 
pressing M. The cursor may be moved with the arrow 
keys, and the action of the modification control keys 
are the same as in the ZAP utilities. See table 2-2 
for the various keys and their actions. 

In memory modification mode, however, if you 
attempt to move the cursor past the display window, 
more data will simply be brought in, one byte at a 
time. If you attempt to move the cursor past the 
highest address in the computer, FFFFH, the display 
will wrap around to display 0000H. Pressing ENTER in 
modify returns to paging mode. 



II. MOVE MEMORY 




This routine enables you to move a block of 
memory from one location to another. You will be 
prompted for the starting and ending address of the 
block to be moved, and the starting address where it 
is to be moved to. The prompt will look like this: 

Start, End, Start ? 

If you wanted to move the bytes located at 7000H 
through 70EBH inclusive to a new location starting at 
AB44H, you would then reply as follows: 

Start, End, Start ?7000H,70EBH,AB44H 
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and press ENTER. The routine will then execute the 
memory move, and you will be advised of the number 
of bytes moved. 

Be careful when moving things around in the lower 
37K of memory, which is occupied by Super Utility 
Plus itself! If you move a block of memory into a 
location being used by the program, you may destroy 
vital parts of it and find yourself facing a disastrous 
system crash. 

III. EXCHANGE MEMORY 

This routine is similar to "Move memory," except 
that it actually exchanges the contents of the origin 
and destination blocks of memory instead of merely 
copying the contents of the origin block over what 
was in the destination block. 

The prompts will be identical to Move Memory, and 
will request the starting and ending locations of the 
origin memory block, and the starting location of the 
destination memory block where the exchange is to 
take place. For example, if you wanted to exchange 
the contents of the block of memory in 8000H through 
87FFH with the contents of memory at C000H, your 
reply would be 

Start, End, Start? 8000H,87FFH,C000H 

and when you press ENTER, the two blocks of 
memory will be exchanged. The bytes which resided at 
8000H through 87FFH now reside at C000H through 
C7FFH, and vice versa. 
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IV. COMPARE MEMORY 

This option permits you to compare one block of 
memory with another. Suppose you had executed a 
memory move using option 1 and wished to verify if 
the move was properly executed. You would then enter 
the starting and ending addresses of the original block 
and the starting address of the comparison block. 

The program will do a byte-by-byte comparison of 
the two blocks of memory and advise you of any 
mismatches that it finds. If there are many such 
mismatches, they will scroll past on the screen at a 
high rate of speed, but the display may be paused by 
holding down the spacebar. 



V. FILL MEMORY 

Memory may be filled with a single byte value 
using this routine. You will be p prompted for the 
starting and ending addresses of the block to be 
filled, and the byte value to use as the filler. For 
example, if you wanted to fill the memory locations 
from DAOOH through DFFFH with the byte OAH, you 
would enter, DA00H,DFFFH,0AH. 




All of the address entries have default values. The 
starting address location defaults to the first byte 
beyond the end of the Super Utility Plus program 
itself, and the end byte defaults to the top of 
memory. The fill byte defaults to 00. Thus, pressing 
ENTER at this prompt will zero all memory not used 
by Super Utility Plus and can be used to "clean up" 
memory for other procedures which may require use of 
this space (such as "Track to Memory" -- see below). 
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Be careful when using this routine in the lower 
37K of memory as you could wipe out a critical part 
of Super Utility Plus and cause the program to crash. 
You can easily determine the first free memory 
address by selecting Display Memory and hitting 
ENTER in response to the address prompt. Super 
Utility Plus will display the first 256 bytes of FREE 
memory. You should not do any FILL MEMORY 
function below the address on the upper left hand 
corner of the display. 




VI. REVERSE MEMORY. 

This option performs the same function as the 
"Reverse Sectors" option of the ZAP Utilities, except 
that it works on a block of memory rather than on a 
disk sector, and the area to be reversed is not limited 
to 256 bytes. You only need to enter the starting and 
ending addresses of the memory block to be reversed, 
and the routine will execute immediately. On 
completion of the routine you will be advised of how 
many bytes had been reversed. Note that unlike 
Reverse Sector Data, which is sector oriented, this 
routine is block oriented and will perform the reversal 
from the starting address to the ending address 
inclusive. To see the effect of this routine, try 
reversing 1024 bytes starting at 3C00H (0C00H on the 
MAX-80). 



VII. TEST MEMORY 



This option will perform a test of the region of 
memory that you specify. The test is a very complete 
one, but will not disturb t he previ ous contents of the 

tested addresses! After each byte is tested, its 

original contents are restored. Thus you could test the 
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region of memory occupied by Super Utility Plus 
without destroying the program in memory. 

There is, however, an exception to this. You 
cannot test the actual locations from which the 
routine executes, or it may malfunction and behave 
unpredictably. Thus, when you select this option, you 
will see the message, 

DO NOT test between xxxxH and yyyyH !! 
Start, End ? 

xxxxH and yyyyH are the locations where the test 
routine executes from, and altering them at the wrong 
time will definitely cause unwanted results. 

To use this routine, merely enter the starting and 
ending addresses of the block of memory you wish to 
test and press ENTER. The memory test may be 
stopped at any time by pressing the CLEAR key. 

If you attempt to test the addresses occupied by 
the BASIC ROMs (read only memories), you will get a 
display indicating that every address is bad. This is 
because ROMs cannot be written into. 

MAX-80 users should not test the memory region 
0700H through 08FFH! This is the movable I/O region 
of the MAX-80, and writing to this area of memory 
will cause unpredictable and possibly catastrophic 
results. 




Also, if you test the video RAM on a Model I 
without a lower-case modification installed, those 
addresses (3C00H through 3FFFH) will also be reported 
back as being bad. However, this is normal (the video 
memory on an upper-case -only Model I only has 7 
bits per byte instead of 8) and does not indicate that 
something is wrong with your video memory. 
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Any errors encountered will be displayed by this 
routine, and you will be given a bit-by- bit breakdown 
of the problem addresses. 




VIII. JUMP TO MEMORY 

This option will allow you to execute a jump, or 
transfer of control, to any memory address you select, 
and you need only enter that address. This would 
normally be done if you wanted to jump to your own 
machine-language subroutine in high memory, for 
example. This routine is written in such a way that a 
simple RET instruction (C9H) will bring you back into 
Super Utility Plus. However, DO NOT try jumping into 
random locations blindly, especially into the Super 
Utility Plus program! Know what you are doing before 
trying a jump to memory! 



IX. STRING SEARCH 

This routine will allow you to search memory for 
the occurrence of a particular ASCII string, byte 
string, or two-byte word string, and replace them with 
another string of your choosing. The routine works in 
the same fashion as the STRING SEARCH routine of 
the ZAP Utilities, except that this one works on 
memory, not disk. You must enter the starting and 
ending locations of the memory block to be searched. 
Next you will be asked to enter the string to be 
searched for. 

Enter an ASCII string directly. Surround the string 
with double quotes if you want an exact case match 
on the search, or with single quotes if you want a 
case independent search to be made. To enter a byte 
string, enter a series of values in the range - 255 
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decimal and separate them with spaces or commas. 
The values may be entered in any of the acceptable 
numeric bases recognized by Super Utility Plus. To 
search for two-byte WORD strings, enter two-byte 
values separated by spaces or commas. The two-byte 
values should not exceed the range - 65535 decimal. 
Remember that the routine will reverse the order of 
two-byte words in order to correctly search out 
address references, which are kept in LSB-MSB (least 
significant byte - most significant byte) order. Also, 
note that leading zeroes may cause the program to 
evaluate a two-byte value into one byte. For example, 
0033H would evaluate to 33H instead of 3300H. 



As with the search string function of the ZAP 
utilities, you may enter a search string of intermixed 
ASCII, one-byte values, and two-byte values. 

If you do not wish to replace the original string, 
merely press ENTER when prompted for the 
replacement string, and the program will display the 
matches as it finds them, along with their locations. 
If there are many of them, they will scroll past at a 
high rate of speed. Hold down the spacebar to 
temporarily stop the display. If the string was to be 
replaced, they will be replaced at this time. Remember 
that if the replacement string is longer than the 
search string, it will be truncated to the length to 
the search string. However, if the replacement string 
is shorter than the search string, only the 
corresponding number of bytes in the search string 
will be replaced. 



X. INPUT BYTE FROM PORT 




This option will allow you to input and display a 
byte from a hardware port. You need only supply the 
port number from which you wish to input. For 
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example, if you wished to read the modem status 
register on your machine (port E8H) you would reply 
E8H (or 232 in the default decimal base) to the 
prompt, "PORT ?" and Super Utility Plus would 
immediately return the value in that port. 




XI. OUTPUT BYTE TO PORT 

Conversely, this option permits you to send a 
particular byte out to a hardware port of your choice. 
You will be asked for the PORT number and the byte 
you wish output to it. Upon hitting ENTER, Super 
Utility Plus will immediately send that byte out to the 
specified port. There will be no acknowledgement. To 
see the effect of this option, hook up your cassette 
recorder to your TRS-80, press the PLAY button, and 
select this option. In response to the PORT.BYTE? 
prompt, enter FFH,4 (ECH.2 for the Model III). You 
will see that the cassette recorder's motor has been 
turned on. To turn it off, enter FFH,0 (ECH,0 for 
Model III). 



XII. MEMORY TO SECTORS 



Selection of this option will allow you to write out 
to disk a block of memory. It requires that you input 
the starting byte of the block of memory you wish to 
move to disk, and whether the sector to be written is 
to be in IBM format or not (see the discussion of 
data address marks in chapter 2). You will then be 
asked to supply the drive number, the track number 
and starting sector to be written on your disk. Finally 
you will be asked how many sectors are to be written. 

If you specified IBM format, then sectors 
consisting of 256-byte memory blocks will be written 
to disk, starting at the address which you specified. 
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Memory saved to the disk this way is NOT noted 
in the disk's directory, so it will remain invisible to 
the DOS unless you make an entry in the diskette's 
directory for it. However, assuming that you remember 
the locations on the disk where you wrote it out, you 
may reload the sectors back into memory using Super 
Utility Plus (see the next option). 



XII. SECTORS TO MEMORY 

This option permits you to read in any sectors 
from disk into a specified region of memory in your 
TRS-80. You must know the locations on the disk 
which you want to load, and you must also know 
where in memory you want to load the data. There 
are three prompts under this option. The first is 

Drive, Track, Sector ? 

Enter the drive number, track number, and s tarting 
sector number that you wish to load into memory. You 
will then be asked, 

Sector count ? 

Enter the number of sectors you wish to read into 
memory. If you attempt to load more sectors than 
your memory can hold, Super Utility Plus will detect 
this and load only what it can. You will be informed 
of how much was actually read into free RAM. 




Finally, you are asked, ADDRESS ? Here you must 
enter the starting memory address that you wish to 
load the sectors into. If you wished to load the 
sectors into memory starting at address A000H, you 
would reply A000H and press ENTER. This should 
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normally be defaulted by pressing ENTER, however, 
since the default value will point to a safe area in 
memory away from any region used by Super Utility 
Plus. 

Upon pressing ENTER to the ADDRESS prompt, the 
disk sectors you specified will be read into memory. 
You will then be informed whether or not any sectors 
could not be loaded (this would happen if there was a 
flaw on the disk). Then you will be given the message, 
PRESS <ENTER> TO DISPLAY. 

Pressing ENTER will immediately display the region 
of memory that was just loaded from disk, in the 
DISPLAY MEMORY format. In effect you will be in 
DISPLAY MEMORY mode, and you may carry out any 
operations that are available to you in that mode. You 
can exit back to the menu by pressing BREAK, or to 
the main menu with SHIFT-BREAK. 



£-^^'"j£V"-*^; 



XIII. MEMORY TO TRACK 

This option will permit you to write a section of 
memory out to the disk as ONE track. You are asked 
to input the starting address in memory for the write 
operation, the drive number, and the track number to 
be written. A track's worth of data starting from the 
address which you specified will be written out to 
disk. 

BE CAREFUL WHEN USING THIS OPTION!!! This 
procedure assumes that you have constructed in 
memory an image of a formatted disk track, which not 
only consists of the data to be written, but also the 
actual formatting information that the DOS (and Super 
Utility Plus itself!) needs to read it. This includes not 
just the actual sector data but also the header fields , 
the data fields , the CRC bytes and the inter-sector 
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gap bytes. If any of these are not present or are 
incorrectly positioned, you will have constructed a 
totally unreadable track on your disk with NO way to 
read it back in. It is strongly suggested that if you 
do not have any experience in constructing format 
tracks, that you do not attempt to use this option 
unless there is valid track data in memory already, 
created by the "Build Format Track" utility. 



XIV. TRACK TO MEMORY 




This option will read a full track of data into 
memory, including all formatting information such as 
sync fields, data address marks, gaps, etc. You will be 
asked to input the drive number and track number 
where you want to start examining. Then you will be 
asked whether you want the floppy disk controller to 
synchronize on the ID address marks during the read 
or not. This means that the controller chip will start 
its accumulation of data at the data address marks 
rather than elsewhere. If you want this option, reply 
"Y" otherwise reply "N". 

An entire track of information will be transferred 
from the disk into a holding buffer in memory, and 
you will be informed where it is located. You may 
view the data by pressing ENTER. This will also put 
you in DISPLAY MEMORY mode, with all the 
operations described above available. 

Note that the TRACK TO MEMORY operation is 
not reliable when double-density tracks are involved. 
The reason is that when reading a double-density 
track, the floppy disk controller chip automatically 
synchronizes to ID marks regardless of what you told 
Super Utility Plus to do . Certain bit patterns can fool 
the FDC into thinking that it is looking at an ID mark 
and cause it to re-synchronize. The net effect is lost 
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data. An example of this is a track with the word 
"TRSDOS" somewhere in it. The FDC will see the bit 
pattern of the "T" as an ID mark and try to 
re-synchronize at that point, resulting in a bad read. 
But if the capital "T" is changed to a lower-case "t", 
the FDC will NOT attempt to re-synchronize. 




Experienced programmers can use this option to 
create protected tracks on a disk, for example, by 
changing the CRC bytes on each sector so that a 
standard DOS will always signal an error, or changing 
the actual track numbers or sector numbers so that 
the DOS will not be able to read the track at all. 
The altered track can be written back out to disk 
with the MEMORY TO TRACK option, above. However, 
this exercise should not be undertaken lightly by 
people who have little experience with disk formatting. 
You could create an unreadable disk otherwise. 

To see the difference between this procedure and 
the DISPLAY DISK SECTORS procedure in the ZAP 
utilities, use this option to read in the directory track 
of a TRSDOS disk and examine it. Then examine the 
same track using the DISPLAY DISK SECTORS option 
and you will see the difference. The DISPLAY DISK 
SECTORS procedure does not show you the formatting 
information written on the disk. 
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CHAPTER 9 - FILE UTILITIES 



The final group of routines available in Super 
Utility Plus are the FILE Utilities, selected by 
pressing 8 at the main menu (7 if using the MAX-80 
version). These routines operate very much like the 
ZAP utilities, except that they are file oriented rather 
than disk-oriented. This means that if you display a 
file using the FILE Utilities, you will be able to view 
all of that file even though it may be in two or more 
segments located at different places on the disk. The 
FILE Utilities use the file information maintained in 
the diskette's directory to know where to find the 
file. Of course, this also means that you cannot use 
the FILE Utilities to examine a file on a disk with a 
non-standard or missing directory. 

The available utilities in this group are as shown 
on the menu: 




* f 

xx SUPER-UTILITY + xx VERSION 3.1A xx BY: KIM UATT xx 
(C)(P) 1983 BREEZE/QSO, INC. ~ DALLAS, TEXAS 



.. FILE UTILITIES 

1 . DISPLAY FILE SECTORS 

2 COMPARE FILES 

3 _ COPY FILES 

4 DISK DIRECTORY 

5 FREE SPACE 

6 OFFSET FILE 

7 _ FILE LOCATIONS 

CHOICE? • 



8 . DRIVE STATUS 

9 . SECTOR ALLOCATION 

10 BUILD FILE 

11 . CLEAR FILE 

12 . DISK ALLOCATION 

13 _ COMPUTE HASH CODE 

14 COMPUTE PASSUORDS 
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This option requires the input of the filename that 
you wish to see. Do not forget extensions and drive 
numbers when entering the specification. Super Utility 
Plus will search its directory when you press ENTER. 
If it finds the file, it will display the following 
information: 

END OF ALLOCATION SECTOR NUMBER (EOA) - 

Since a standard DOS allocates disk space in granules, 
it often happens that a file will not completely fill up 
the last granule allocated, so that one or two sectors 
are allocated to it but are actually empty. The EOA 
number displayed by Super Utility Plus refers to the 
last sector of the last granule allocated to that file 
by the operating system. 

END OF FILE SECTOR NUMBER (EOF) - This is 
the LAST sector of the file which actually contains 
file data. It may or may not agree with the EOA 
number, but will normally be within the last allocated 
granule. 

Super Utility Plus will then prompt you for your 

CHOICE ? 



This refers to your CHOICE of which sector in the 
file to view. You need to enter your choice in 
relative sector form, that is, the first sector of the 
file is Sector 0, and so on. If you wish to begin 
viewing the file from the first sector, merely press 
ENTER; otherwise enter the sector number you wish 
to see. 

Once the display is on the screen, then you may 
move through the file by using other keys. The arrow 
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keys will page through the file as usual. Tn addition, 
you may go to the EOF sector by pressing "E" or to 
the EOA sector by pressing "A". Pressing the CLEAR 
key will allow you to select another sector to view. 



TABLE 8-1 - FILE UTILITIES PAGING CONTROLS 



■&£ 
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;« , !**"-£ 


>*■:'$ 






$"'£';&. 
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Key 
Right or Up arrow 

Left or Down arrow 

Sh-right/Sh-up arrow 

Sh-left/Sh-down arrow 



Action 

pages to the next higher 
sector of the file 

pages to the next lower 
sector of the file 

displays last allocated sec- 
tor of the file 

displays initial sector of 
the file 



CLEAR requests new relative sec- 

tor to display 

E displays end-of-file sector 

BREAK Returns to File Utilities 

menu 

Shift-BREAK Returns to main menu 

@ Enables DECRYPT mode 

(see chapter 2). You may 
need to press SHIFT-® 
depending on the CASE 
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setting of the keyboard 
(toggled with shift-0). 

Sets modification mode base 
to hexadecimal, decimal, 
binary, octal (0 and Q are 
the same) or ASCII respec- 
tively. 




The arrow keys are used to page through the file. 
The right and left arrows or the up and down arrows 
may be used (in this routine the up and down arrows 
perform the same function as the right and left 
arrows) to go through the file one sector at a time. 
If you attempt to page beyond the limits of the file, 
you will be given an error message. 

At any time, you may enter Modification Mode by 
selecting your input base (H for hexadecimal, D for 
decimal, B for binary, O or Q for Octal, or A for 
ASCII) and then pressing M. All the modification 
controls available in the DISPLAY DISK SECTORS 
routine of the ZAP utilities are available to you. See 
Table 2-2. 

The screen display of DISPLAY FILE SECTORS is 
very similar to that of the DISPLAY DISK SECTORS; 
however, the leftmost column of information is 
different, as you can see on the next page. 
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L00827QQ 
HEX B1080EQC 
DRV A2Q83801 

Q S3082C23 
TRK 14082187 

26 C5085152 
TRU /608CDF4 

26 C7Q85BB1 
SEC M80822A0 

08 D9Q88A42 
5T0 AQ86406 
ODD BQ8QQ00 
FPDE CQ87A2F 
R5EC DQ8A720 
0D02 E088764 
+00 -FD8D4F1 



EOBQ 2100 
EDBO 2A11 
EB22 AQ40 
22A7 4D11 
5236 OOCO 
CDA7 2818 
5321 0000 
402A 1144 
40CD 5D1B 
37C3 C657 
0A73 2372 
1188 52CD 
3211 4211 
C37B FE10 
0122 01F5 
22A7 6436 
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0022 8E40 2193 4E11 004Q8'.88!..»83!8N..3 
44ED 5B70 53FE 2A20 04DF8..88».D8[}S8K .8 
F921 2853 363A 2370 233688. 8*838! (S6:8P86 
5241 2100 4E01 9300 EDB08,8"83.RA! .N.8.88 
8F1B 3A1F 44FE 5130 08218!8R6.88.:.D8Q0.! 
3B3E OOFE 2A20 3E3A BE408QR88(.;>.8» >:83 
22A0 4021 0000 22A4 40ED888S! .."83! .."838 
OF30 0022 B140 11CE FF198[83x.D80."83.88. 
0118 1AC3 AE19 2179 52CD8»83tt]....88.!YR8 
2169 5218 F411 C362 21A98BB7«8U!IR.8.8B!8 
2310 FA21 0000 22BD 64218D..S8R8.8! ..»8D! 
5444 20DC 22C9 5311 00008. ..8R8TD 8*85... 
FFFF 7A32 8F40 1103 007A8Z/2.B.88Z283. ..Z 
30BE 328E 403C 21BF 641188 8{8.0»283<!8D. 
3A01 0200 548F 40A7 280188D/.8' ...T838(. 
OOEB 7323 7223 EBQ9 3D208.8"806.858R88.= 




The leftmost column of information first gives you 
the current modification mode base. Then it displays 
the drive number, the track number, and the sector 
number being displayed. Then it displays the data 
address mark type that it found on the disk (see 
chapter 2 for details) along with the density of the 
disk » OSD for single-density, ODD for double-density. 
The first character will be either or 1, indicating 
which side of a disk you are viewing. At the bottom, 
you will see three lines that look like this: 

FPDE 

RSEC 

OOOO 

FPDE stands for "File Primary Directory Entry." Here 
it means that the sector you are viewing is allocated 
in the file's primary directory entry. If it said FXDE, 
then the sector you are viewing is allocated in the 
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one of the file's extended directory entries. TRSDOS 
1.3 does not use FXDE's, so this message should never 
appear if you are scanning a disk formatted by this 
particular system. 

RSEC stands for Relative Sec tor. The value then 

displayed on the third line is the relative sector being 

displayed as taken from the directory information for 
that file. 

Next to this column is a single vertical column 
which displays the NAME of the file being viewed, for 
example, 



B 
A 
S 
I 
C 
/ 
C 
M 
D 




Toward the bottom of this column, you will see one of 
three symbols: -, +, or @. The minus sign <"-") 
indicates that you have not yet reached the EOF 
sector of the file; The plus sign ("+") indicates that 
you have already passed the EOF sector and are 
viewing a sector that was allocated to the file but 
not used by it. The @ symbol indicates that you are 
viewing the EOF sector itself. When this symbol 
appears, there will be a hex number above it, viewed 
vertically. This is the first available byte after the 
end of the file itself. The last byte of the file would 
be the one preceding this byte. 
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If this number is 00, it means that the last byte 
of the file was at relative byte FFH of the preceding 
sector. 



TRSDOS 1.3 and 2.7DD system files need to be 
handled slightly differently in order to be viewed. This 
is due to the lack of a standard directory entry for 
the system files. If you want to view a system file on 
either of these two systems, for example SYS5, and 
the TRSDOS disk is on drive 1, reply to the prompt 
as follows: 

FILENAME ? *05:1 

If the file is inactive in the directory (that is, it has 
been killed), a "File not found" message will be issued. 
This format will work only for DISPLAY FILE 
SECTORS and only for TRSDOS 1.3 and 2.7DD system 
disks. 




If a disk error is encountered, Super Utility Plus 
will display a message describing the error and give 
you the option to retry the I/O operation with the 
prompt, 

R>etry, S>kip, Oontinuous, N>onstop or Q>uit ? 

Pressing R will cause the program to retry the I/O 
operation. If the error was due to a momentary 
condition, this is usually sufficient to correct the 
situation. If the error appears again, you may select 
the Continuous or Nonstop options, which will force 
Super Utility Plus to keep trying to read the bad 
sector until it gets it right or you stop the process. 
The only way to escape this is a successful I/O 
operation or by pressing CLEAR, BREAK or 
SHIFT-BREAK. 
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If you press S, for Skip, Super Utility Plus will go 
immediately to the sector display routine, with 
whatever it was able to read before the error forced 
it to stop. If it was unable to read anything, the 
display will show all 00's. If it was successful in 
doing a partial read of the sector, then whatever it 
was able to read will be displayed. Note that this may 
not be the same as what is actually on the disk. An 
error of any kind should always alert you to the fact 
that the data in Super Utility Plus' buffers may be 
unreliable. 




Pressing Q for Quit will abort the entire operation 
and return you directly to the File Utilities menu. 



II. COMPARE FILES 

This routine will allow you to compare two files 
byte by byte and see if any mismatches exist. You 
may find this routine useful if, for example, you have 
doubts about the integrity of a particular file and 
wish to check it against another copy. You will be 
asked to enter the source filename (don't forget the 
drive number!) and the compare filename . Super Utility 
Plus will scan the two files and report any mismatches 
on your screen: 

MISMATCH, RELATIVE SECTOR 0000H, BYTE 

CFH 



At the end of the scan, you will be told how many 
disk errors (due to CRC errors, etc) were encountered, 
if any, and the total number of sectors in which 
mismatches were found between the two files. 

Super Utility Plus will compare files up through the 
EOA (end-of-allocation) sector . This means that two files 
may show a number of mismatches toward the end. The 
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reason for this is that the contents of sectors beyond 
the EOF sector is indeterminate. If this is of concern to 
you, use DISPLAY FILE SECTORS to verify that the 
differences appear only after the EOF sector. 

Also, if the source file for the comparison is shorter 
than the destination file, but matches the destination 
file through that point , no mismatches will be reported. 
If you suspect this is the case, reverse the order of the 
comparison, i.e., make the destination file the source file 
and vice versa. Then run the file comparison again. 
Super Utility Plus will report an error if it encounters 
the end of the destination file before the source file. 




III. COPY FILES 

This routine is a very fast multiple-file copy utility 
which will let you move any number of files between 
two disks, the only restraint being the available space 
on the destination disk. You are asked to supply the 
source drive number. Super Utility Plus will then read 
the directory of the diskette in the source drive and 
display a directory listing on the screen. At the 
bottom of the screen you will see a filename, followed 
by its length in grans and sectors, followed by the 
query, COPY ? 

If you press "Y", the filename will scroll upward 
and you will be presented with another filename. If 
you press "N" then the filename will be replaced with 
another one without scrolling. If you hold down either 
key, it will repeat until all the files have been 
"tagged" for copy or not. 

When the last file has been "tagged," you will be 
asked for the destination drive. Super Utility Plus will 
scan that drive and display the number of sectors to 
be copied (the total number of sectors occupied by ail 
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the files tagged for copy) and the number of sectors 
available on the destination disk. It will then proceed 
to copy the files over one by one. You may specify 
the same disk drive for destination as for source, and 
you will be prompted for disk swaps as needed. 
However, make sure that both source and destination 
disks are the same DOS type. This is mandatory for 
single-drive copy operations. 




If a file already exists on the destination disk, 
Super Utility Plus will display a line of asterisks, 
***** " beside the filename as it copies to indicate 
that that file is being overwritten. If there is not 
enough space on the destination disk to hold all the 
files, the routine will display a message to that effect 
before starting the copy. 

After the last file has been copied over, the 
directory of the destination disk is updated and 
written back out to the disk. 

This routine will place the files starting at the 
lowest available track/sector on the destination disk 
and building upward from there, without leaving any 
gaps between files. It is a very good routine to use if 
you wish to "pack" a disk. Where possible, the file 
copy routine will keep the file in just one extent 
rather than splitting it up. 



If you are copying a file from a TRSDOS 1.3 or 
2.7DD formatted disk to a formatted disk created by 
another system or vice versa, Super Utility Plus will 
deliberately strip any passwords which may have been 
set for the source file. The reason for this is that 
Model III TRSDOS computes passwords differently 
from other operating systems and if the encoded pass- 
words were copied over, even if you gave the correct 
password, it would not be recognized. If you have any 
password-protected files on your source disk, you must 
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reassign the passwords using the ATTRIB command of 
the operating system on the destination disk after the 
copy routine is completed, or use Super Utility Plus' 
CHANGE FILE PARAMETERS procedure. 

Copying a file to a TRSDOS 1.3 or 2.7DD disk 
from some other system will result in garbage being 
displayed for the file's creation date when a DIR is 
done under these two systems. The reason for this is 
the fact that TRSDOS 1.3 and 2.7DD, unlike all other 
systems which maintain file dates, do not maintain the 
dates in a bit-coded fashion, rather they reserve one 
byte for the month and one byte for the year. These 
bytes usually contain some other information, and is 
not changed by Super Utility Plus when it constructs 
the destination file entry; hence garbage may appear 
for the date. If you wish to change the date on 
these, display the directory entry for the file and 
modify relative bytes 1 and 2 of the directory entry. 
Relative byte 1 contains the month in hexadecimal, 
and relative byte two contains the two-digit year in 
hexadecimal. 




If you press BREAK during the copy process, you 
will be returned to the File Utilities menu, and the 
destination directory will not be updated. 

Due to memory limitations in the standard TRS-80 
computer, COPY FILES will not work if either the 
source or the destination disk is double-sided. This 
procedure requires that both directory tracks (source 
and destination) be buffered in memory during the 
copy process. Double-sided, double-density directories 
require 9K each for a total of 18K, which is one-third 
of the total available memory in the computer! If you 
attempt to run this procedure with a double-sided disk 
as either the source or destination, Super Utility Plus 
will display the message, "Cannot copy to or from long 
directories!" and abort. 
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COPY FILES is valid for double-sided disks on the 
MAX-80 version of Super Utility Plus, however, since 
this version of the program resides much lower in 
memory than does standard Super Utility Plus. 




IV. DISK DIRECTORY 

This routine will display the directory of the 
disk(s) specified. You will be asked for the drive num- 
ber. You may specify more than one, separating each 
number with commas or spaces. Super Utility Plus will 
scan the disks in order and display for each one the 
disk name, date, number of formatted tracks, number 
of free granules, and number of free directory slots. 
It will then display all the valid files on the disk, 
along with commas or spaces. Super Utility Plus will 
scan the disks in order and display for each one the 
disk name, date, number of formatted tracks, number 
of free granules, and number of free directory slots. 
It will then display all the valid files on the disk, 
along with their file attributes and protection levels. 
For example, 8IP-°7 means a file is a system file, is 
invisible, and has a protection level of 7. 



V. FREE SPACE 



Selection of this option will cause Super Utility 
Plus to scan all mounted disks and display the disk 
name, date, number of formatted tracks, number of 
free granules, free space in Kilobytes and number of 
free directory slots for each disk. The mounted disks 
must all be readable, that is, they must have been 
formatted by a TRSDOS or TRSDOS-compatible system 
(Model I or Model III) and must contain recognizable 
directory tracks. If a non-standard disk is on any 
drive, you will be presented with an error message. 
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VI, OFFSET FILE 

This routine will allow you to load a file into me- 
mory at one location and cause it to relocate and 
execute from another location. You may even set up 
the file so that the TRS-80 interrupts are disabled 
prior to execution. The file must be in load file for- 
mat. BASIC program files cannot be relocated. 

This routine is useful for making executable files 
of those programs which normally destroy part of the 
DOS when they load into memory. Generally, programs 
written for tape-based systems do this, since they load 
on top of the DOS resident module. You may move a 
tape-based (SYSTEM-type) file to disk using the tape- 
to-disk utilities of your disk system, then use this 
option to move the file so that it does not destroy 
the DOS until it is safely loaded into memory. Once 
the program is in memory, it can be relocated to its 
normal addresses for execution. 




Super Utility Plus will first ask you to supply the 
filename to be offset. It will then scan the file on 
disk and tell you the load module range of that file, 
that is, the present starting address, ending address 
and transfer (or execution) address of that file. If the 
file you specified is not an executable load module, 
the procedure will abort with an error message. 

You will then be asked to supply the new load ad- 
dress, i.e., where you want it to reside when loaded 
from disk. You will then be asked if you want to add 
the block move APPENDAGE to the file. This is a 
short routine which will cause the file to be block- 
moved to its normal execution addresses after loading 
into memory. Normally, machine-language files must 
reside in a particular place in memory in order to exe- 
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cute properly, so if you want the file to execute, you 
will want to add this appendage. 

If you elect to have the appendage added to your 
relocated file, Super Utility Plus will check to see 
that there is enough disk space allocated to the file 
to accommodate it. More disk space will not be allo- 
cated to a file by this routine. It will display an error 
message if insufficient room exists for the appendage 
routine. 

You will then be asked if you want the interrupts 
disabled or not. Some programs will not execute 
properly unless the interrupts are disabled. You will 
have to determine whether the program you are 
offsetting will work correctly with the interrupts 
enabled or disabled, and set this option accordingly. 

When you press ENTER to complete this last 
prompt, the file will be written back to disk in its 
relocated form, and from then on will always load into 
the new locations when executed from DOS READY 
level. If you used the block move appendage, it will 
preserve the contents of the Z-80 registers at load 
time so that if your program requires them, it will 
still function correctly. 




VII. FILE LOCATIONS 



This option will display complete directory 
information about each file on a designated disk. You 
will be asked to enter the drive number to be 
scanned, and you may enter more than one drive 
number. Each drive specified must contain a standard 
formatted disk with a readable directory track. The 
disks will be scanned one by one, and information 
about each file in the directory will be displayed, 
once file at a time. The screen dump will pause to 
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give you a chance to examine the information; press 
ENTER to display the next file. There is a brief 
delay built into the keyboard scan for this routine, so 
that holding the ENTER key down will display the 
files at a fast, but not overly fast, rate. 



For each active file on each disk, five lines of 
information will be displayed. For example, 

8YS1/SYS SIP=7 

FPDE-:0,TRACK=20,SECTOR=05,BYTEH)0H,DEC=03H 

EOFS = 00005, EOFB - 00H, LRL = 

EACC = C352H, EUPD - C220H, GRANS - 01 

EXTENTS / 19,00,00006 / EOF 

The first line gives the file's name and attributes. In 
this example, the file is SYS1/SYS and has the 
attributes SIP-7, meaning it is a system file, invisible, 
with a protection level of 7 ("no access"). 

The second line gives information about the file's 
directory entry. FPDE stands for "File Primary 
Directory Entry," and this entry is located on drive 0, 
track 20 (the directory track), sector 5, starting at 
relative byte 00H. 




If you were to display this sector on the screen 
using DISPLAY DISK SECTORS, you would see an 
entry for SYS1/SYS at that particular location. 

DEC stands for "Directory Entry Code," and is the 
relative byte position of the file's "hash code" in the 
HIT table. In this example, DEC =-03 would mean that 
relative byte 03 in the HIT sector of the directory 
contains the "hash code" for SYS1/SYS. The DEC's 
position in this table is relevant to the position of the 
FPDE, and this table is used by the DOS to locate 
files in the directory at high speed, without the need 
to search through the directory sectors one by one. 
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The third line gives information about the file's 
EOFS (end of file sector) and EOFB (end of file byte). 
The EOFS value is the last sector used by the file 
(not necessarily the last sector allocated to the file) 
and the EOFB is the last byte of the file within the 
EOFS. 




The fourth display line gives the encoded values of 
the passwords. EACC stands for Encoded ACCESS 
password. It is followed by the two byte hash code of 
the file's password, if any. EUPD is the Encoded 
UPDATE password and is the two-byte hash code of 
the file's update password. Note that the bytes are 
displayed in LSB/MSB order, which is the way that 
you would see them on the disk if you viewed the 
directory using Disk Zap. For example, the hash of a 
password may be 42E0H, but would appear on the 
screen as E042H, which is also they way it would ap- 
pear if you viewed the directory records directly. 

Finally, the number of grans occupied by the file is 
given on this line. 

The last line gives the actual location of the file 
on the disk. The first number is the track where the 
file is located, the second number is the starting sec- 
tor (in this case, sector 0) and the third is the length 
of the file (actually the number of allocated sectors). 



On a standard DOS directory, an exceptionally 
large file may require an extra directory entry, known 
as the FXDE or File Extended Directory Entry. This 
is very similar to the FPDE except that the filename 
is not contained in it, and it is not displayed when a 
directory is requested from DOS or Super Utility Plus. 
If such a file was encountered by Super Utility Plus, 
additional information would have been displayed, giv- 
ing the FXDE's directory entry code and extents. 
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TRSDOS 1.3 does not allow FXDE's, so this display 
should never appear when a TRSDOS 1.3-formatted 
disk was being scanned. 



VIII. DRIVE STATUS 

This option will cause Super Utility Plus to check 
the status of all active drives in your system and re- 
port back on each. Drives which are disabled from the 
configuration tables, or not powered, will be reported 
as NOT IN SYSTEM. Drives with no disks but other- 
wise powered up will be reported as such. 

This procedure cannot properly detect the "no dis- 
kette" status on some of the newer microprocessor- 
controlled drives (or 8" drives on the MAX-80 version) 
due to differences in status signals being returned by 
the drive unit. Such drives will be reported by Super 
Utility Plus as NOT IN SYSTEM. You should be aware 
that this will cause that drive to be DISABLED in the 
configuration table. You will have to return to the 
configuration system and re-enable the drive before 
you can use it for anything else. 




If drives are found to be NOT IN SYSTEM, the 
settings for them will automatically be changed in the 
configuration table to reflect this fact. Thus if you 
had a drive turned off when you executed this proce- 
dure and later turn it on in order to use it, you must 
return to the configuration table and restore it to an 
active status by changing the active/inactive indicator 
for that drive (the plus or minus sign in front of the 
drive number -- see Chapter 1 for full details on con- 
figuring). 
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On the MAX-80 version DRIVE STATUS may return 
unpredictable results if the 5-inch select switch inside 
the computer (at the 5-inch floppy card edge connec- 
tor) is set to the RS position. 




IX. SECTOR ALLOCATION 

This option will let you enter a track and sector 
number on a mounted disk and will report which file 
that particular sector is assigned to, if any. You will 
be asked to supply the drive number, track number, 
and sector number. The disk to be scanned must con- 
tain a readable directory track, since this routine will 
use the directory information to determine whether the 
specified sector is assigned to any active file. If the 
specified sector was assigned to a file that has been 
killed, it will be reported as unassigned. 



X. BUILD FILE 



This routine will allow you to create and pre-allo- 
cate space on a disk for a file in as contiguous a 
manner as possible. The pre-allocated space will be 
noted in the file's primary directory entry, so that 
when you write to this file later on, using your DOS, 
you will do so faster since the DOS will not need to 
keep returning to the directory to find space for a 
new granule every so often. 

You will be asked to supply the filename along 
with the drive number in standard TRSDOS filespec 
format. Super Utility Plus will then scan the disk and 
report back the disk's name, date, number of format- 
ted tracks, number of free granules and free directory 
slots. It will then ask you to enter the number of gra- 
nules you wish allocated to this new file. When you 
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press ENTER, the information will be written into the 
disk's directory. 



XL CLEAR FILE 

This routine will request you to enter the filename 
of a pre-existing file on a disk. It will permit you to 
remove all the data from that file without actually 
removing or killing the file from the directory. 

You will be asked, "Are you SURE you want to 
clear it ?" This will give you a chance to change your 
mind. Enter "Y" to proceed with the operation, 
otherwise enter "N". If you press "Y", Super Utility 
Plus will zero out the data in that file. The file will 
still be present in the directory but it will in effect 
be empty. 

Be careful in using this routine, as there is 
absolutely NO way of recovering data from a file that 
has been cleared. 




XL DISK ALLOCATION 

This routine will display a disk allocation map of 
the disk in the specified drive. The tracks will be 
listed in the leftmost column. To the right of each 
track will be slots for each granule, with one of four 
possible symbols: the letter "X", a "." an underscore, 
or the letter L. A granule slot with the letter X 
indicates that that granule is in use, that is, assigned 
to an active file. A slot with a period indicates that 
this granule is available for use. If an n L" appears, 
then that granule was locked out by the DOS during 
the formatting process, perhaps due to a flaw in the 
disk, and is not available. Underscore characters will 



Copyright c 1983 by Breeze/QSD, Inc. 



150 



Super Utility Plus 3.2 



appear in those slots beyond the disk boundaries, that 
is, beyond the last formatted track on the disk. 

The letter "D" will appear on those granules which 
are part of the disk's directory track. 




XIII. COMPUTE HASH CODE 

This routine will calculate the one-byte HIT table 
hash code for any filespec. You will be asked to 
supply the filespec (passwords and drive numbers are 
not required) and the routine will return a one byte 
hash code in hexadecimal. This code is what is used 
by the operating system in the Hash Index Table of 
the directory. 

When the operating system must look up a file, it 
first calculates this code, then goes to the HIT table 
to locate it. If this code is found in the HIT table, 
then its position in the table will correspond to the 
position of the main directory entry in the following 
sectors. The system is then able to quickly locate 
files this way, without having to scan through the 
entire directory each time. 

The hash codes produced by this routine, however, 
are not unique. That is, two or more filespecs, though 
different, can generate the same code. This is known 
as a "collision." The system handles the collision by 
first checking with the main directory entry and 
comparing it with the user-supplied filename. If the 
two do not match, then the system goes back to the 
HIT table to continue the search. 
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This routine will allow you to either encode or 
decode passwords using the algorithms employed by 
the DOS. When this option is selected, you will be 
asked whether you want to Encode or Decode a 
password. To encode a password, simply enter E. You 
will be asked for the password to encode. Type it in, 
and the routine will return the 2-byte hash of that 
password. The algorithm used by this routine will 
depend on the configuration of drive 0. If drive is 
configured for TRSDOS 1.3 (T3D) then the TRSDOS 
1.3 algorithm will be used; if drive is configured to 
T1D, then the TRSDOS 2.7DD algorithm will be used. 
For all others the standard algorithm will be used. 
You may have to enter the configuration routine to all 
the settings for drive to get a correct encode of 
your password. There are no overrides for the 
compute passwords routine. 




To decode a password, enter D. You will be asked 
for a filename. This filename must exist on one of the 
mounted disk. When you enter the filename, Super 
Utility Plus will read that file's directory entry into 
memory. It will then display the two hexadecimal 
bytes which make up the ACCESS password. At this 
time you will see a furiously-changing graphics 
character at the bottom of the screen. This indicates 
that Super Utility Plus is in the process of decoding 
that password. When it finds a password which 
translates into the correct hash code, it will display 
it, and go to work on the UPDATE password. Again 
the graphics character will appear. When it 
successfully decodes the update password, it will 
display it. 

If no password is displayed for either the update 
or access passwords, it usually means that the two- 
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byte hash is a result of BLANK characters, meaning 
there is NO password. 




Pressing CLEAR while the graphics character is on 
the screen will abort the operation and proceed to the 
next step. 

With the exception of TRSDOS 1.3 and 2.7DD, all 
disk operating systems use the same password encod- 
ing algorithm. TRSDOS 1.3 and 2.7DD, however, each 
use a different algorithm. This means that a password 
which encodes one way on other systems will not en- 
code the same way on these two systems. Also, the 
TRSDOS 1.3 algorithm is written in such a way that 
there is one uncodable value -- 0000H. While certain 
combinations of characters will produce a 0000H hash 
encode under TRSDOS 1.3, TRSDOS automatically in- 
crements the value by 1 when this happens. The 0000 
byte pair is used as a protection scheme on certain 
TRSDOS files, to prevent access. 

This difference can produce certain problems, most 
notably that when files are copied from one system to 
the other, formerly valid passwords suddenly stop wor- 
king, and files which had no passwords at all suddenly 
acquire them. Super Utility Plus deals with this prob- 
lem by striipping the passwords from the files after 
the transfer if one of the disks involved is either 
TRSDOS 1.3 or 2.7DD. 
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CHAPTER 10 - MESSAGES 



Below is a list of the messages that Super Utility 
Plus may generate at various points, along with a 
brief explanation of each. Users should make careful 
note of the wording of some of the messages, to pre- 
vent possible confusion. For example, Super Utility 
uses a phrase like "nn sectors not copied" to indicate 
any unsuccessful sector copy operations. If the opera- 
tion was completely successful, however, the phrase 
will appear as "00 sectors not copied," indicating that 
all sectors involved were successfully copied. Don't let 
the double-negative phrasing throw you. 




R>ETRY, S>KIP, OONTINUOUS, N>ONSTOP OR 
Q>UIT? 

When a disk I/O error is encountered, in most ca- 
ses, you will be presented a chance to retry the ope- 
ration. This prompt gives you several options. R will 
retry the operation once; C will retry the operation 
over and over until it succeeds; N is the same as C 
but no error messages will be displayed during the 
process; S will skip the portion of the disk where the 
I/O error occurred; Q will abort the operation com- 
pletely and return you to the menu. 

DRIVE n DE-ACTIVATED 

The specified drive has been disabled in the Super 
Utility Plus configuration table. Change the +/- setting 
for this drive to bring it into the system. 

NO DISKETTE IN DRIVE n 

Self-explanatory 
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DRIVE TIME OUT ! 

The drive shut down 
could be completed. 



Super Utility Plus 3.2 



before the I/O operation 




INTERRUPT ON PENDING COMMAND 

A disk I/O operation was interrupted while a com- 
mand to the floppy disk controller was still pending. 

WRITE PROTECTED DISK 

The diskette has a write-protect tab on it, or the 
drive has been declared write-protected in the configu- 
ration tables. 

HARDWARE WRITE FAULT 

An attempt to write to a disk failed due to a de- 
fect in the drive or controller hardware. 

SECTOR NOT FOUND 

Super Utility Plus attempted to read a sector that 
either was not there (unformatted) or had a non- 
-standard and unreadable format. 



ID CRC ERROR 

The CRC byte for the track and sector ID fields 
was wrong. Usually indicates a flawed format. 

DATA CRC ERROR 

The CRC bytes for the sector data were wrong. 
This may have several causes: the sector is a "protec- 
ted" sector, or the disk drive may be at fault. If it is 
intermittent, suspect a drive fault (e.g., a worn head 
pressure pad). 

DATA LOST 

Data was lost during a read/write operation. Usual- 
ly due to software problems, (the disk transfer code 
of the program was not fast enough to keep up with 
the floppy disk controller). 
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DRIVE DROPPED READY 

A selected drive dropped its "ready" status bit be- 
fore the I/O operation could be completed. 

DISK READ ERROR 

An attempt to read a disk failed. 

DISK WRITE ERROR 

An attempt to write to a disk failed. 

WRITE FAULT 

Usually signals a hardware problem with the disk 
drive's write circuitry. 

DATA LOST ON TRACK WRITE 

While writing data to a track, the timing was off 
by a sufficient amount so that data was lost before it 
could be written. This may happen if the TRS-80 CPU 
has been slowed down. 

nn SECTORS NOT COPIED 

During a copy sectors operation, several sectors 
could not be read for some reason or another. This 
message will usually appear in conjunction with some 
other error message pinpointing the cause of the fai- 
lure. 



nn SECTORS NOT ZEROED 

During a "Zero sectors" operation, several sectors 
could not be written to. Possible causes are a hard- 
ware drive fault, or incompatible ("protected") formats 
on the target sectors. 




nn SECTORS NOT LOADED 

Several sectors could not be read, 
are the same as above. 



Possible causes 



nn SECTORS NOT WRITTEN 

Sectors could not be written during an I/O opera- 
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tion. This message will usually be accompanied 
other error messages pinpointing the cause. 



by 



ERROR ON TRACK WRITE 

An error occurred during an attempt to write 
memory to a disk track. May indicate a hardware 
problem. 

TRACK READ ERROR 

An error occurred during an attempt to read a 
track into memory. 

TRACK IN BUFFER FROM xxxxH TO yyyyH 
HIT <ENTER> TO DISPLAY 

Appears on completion of a successful Track-to- 
Memory operation. The range of addresses occupied by 
the track data will be given. Press the ENTER key to 
view the track data. 




nn GRANULES LOCKED OUT 

Reports the total number of unusable granules on a 
disk following a format operation. 

CANNOT WRITE DIRECTORY ! 

During any I/O operation which requires the upda- 
ting of the diskette's directory, Super Utility Plus was 
unable to do the update. This may occur, for example, 
if the target disk is write-protected. 

nn SECTORS LOST 

During a copy sectors or move sectors operation, if 
some reason prevents one or more sectors from being 
successfully written to, this message will appear at 
the end of the operation. 

nn SECTORS COULD NOT BE VERIFIED 

Reports the total number of sectors that could not 
be verified during a Format or Verify Disk Sectors 
operation. 
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NON-STANDARD FORMAT 

An attempt was made to read a disk that does not 
have a TRSDOS-compatible format. 

DIRECTORY UNREADABLE 

The directory is non-standard, or damaged. 

CANNOT LOCATE DIRECTORY ON DRIVE n 

Super Utility Plus could not read the directory on 
the specified drive. Usually indicates that the directo- 
ry track has been written with incorrect or incompa- 
tible data address marks. 

CANNOT LOCATE DIRECTORY! TRACK? 

The program could not locate the directory and is 
requesting the user to specify its location. 

ALLOCATION TABLE OR E>NTIRE SECTOR? 

During a GAT repair, Super Utility Plus may repair 
only the track allocation table, or alternatively, the 
entire sector including the disk name, date, auto com- 
mand, etc. If you specify E for entire sector, Super 
Utility Plus will insert its own data for disk name, 
date, etc. 

GAT TABLE IS BAD ! 

The Granule Allocation Table (GAT) has been found 
to be damaged or incorrect by the Check Directory 
routine. 




HIT TABLE IS BAD ! 

The Hash Index Table (HIT) sector has been found 
to be damaged or contain errors by the Directory 
Check routine. 

nn TOTAL ERRORS 

Reports the total number of errors found during a 
directory check. 
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BAD EXTENTS ! 

A file has been found to have incorrect extents in 
the directory entry. 

BAD BACKWARD LINK ! 

One or more of a file's Extended Directory Entries 
(FXDE) has been found to not point back to the pre- 
ceding FXDE (or FPDE). 

TRACK ALLOCATED ! 

An attempt was made to move a directory track to 
a track already occupied. 

DIRECTORY THERE ! 

An attempt was made to move a track to the place 
occupied by the diskette directory. 

SOURCE ? 

Prompt for the source drive for a sector or file 
copy or a backup operation. 

DESTINATION ? 

Prompt for the destination drive or drives for a 
file copy or backup operation. You may enter more 
than one destination drive, separated by commas or 
spaces. 

MOUNT DESTINATION DISKETTES 

Prompt to mount the diskettes in all the specified 
destination drives. Press ENTER to proceed with ope- 
ration. 




NO DESTINATION DRIVES ! 

No destination drives were specified for a file or 
sector copy or backup operation. 

UPDATING DIRECTORY TO nnn TRACKS 

This message will appear as Super Utility Plus mo- 
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difies the disk directory's GAT table to reflect the 
added space if FORMAT was used to increase the 
track count on a diskette, or if a backup was per- 
formed between two disks with differing track counts. 

CANNOT UPDATE DIRECTORY 

An attempt to update a diskette directory failed 
for some reason. 

CANNOT COPY TO/FROM LONG DIRECTORIES 

An attempt was made to use the COPY FILES pro- 
cedure when one or both of the disks involved was 
formatted as a double-sided disk. 

DRIVE x MOUNTED AND READY 

Message returned by the Drive Status routine for 
all drives which are powered on and have diskettes 
mounted. 

DRIVE x NOT IN SYSTEM 

Message returned by the Drive Status routine for 
all drives which are either not physically present, not 
powered, or disabled in Super Utility Plus's internal 
configuration tables. 

OPEN DOOR ON DRIVE x 

Self-explanatory. 

INVALID FILESPEC ! 

The user entered a filespec in invalid or non- 
TRSDOS format. The correct format for a filespec is 
"FILENAME/EXT.PASSWORD.D." See your operating 
system manual for more details. 

FILE NOT FOUND! 

The specified filespec was not on the disk directo- 
ry. 
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NEXT SECTOR OUT OF RANGE, 
POSITIONED TO SECTOR xxxxx 

During a Display File Sectors operation, the user 
attempted to page beyond the boundaries of the file 
being viewed. 




SECTOR NOT ASSIGNED TO ANY FILE 

Message returned when the sector specified in a 
Sector Allocation scan is not assigned to an active 
file. It may contain data from a KILLED file, 
however. 

FILE IS NOT IN LOAD FORMAT ! 

An attempt was made to offset a file that is not 
in the correct load module format or was not a 
machine-language file. 

ADD APPENDAGE? 

Prompt to the user to specify whether or not the 
block move appendage is to be added to a file that 
has been offset from its normal load addresses. Reply 
"Y" or "N". 

MISMATCH, RELATIVE SECTOR nnnnn, BYTE xx 

Indicates the position of a mismatch during a file 
compare or sector compare operation. 

nn DISK ERRORS 

nn SECTOR MISMATCHES 

Reports the total number of disk I/O errors en- 
countered, and the total number of sectors in which 
mismatches were found, upon completion of a file com- 
pare or sector compare operation. 



EOF DEST FILE REACHED ! 

During a file compare operation, the end of the 
destination file was encountered unexpectedly. 
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During a file copy operation, any file on the desti- 
nation disk which has the same name as a file being 
copied over will be overwritten with the new data. 

FILE ALREADY EXISTS ! 

An attempt was made to build a file with a name 
that already is in the diskette directory. 

NO SPACE AVAILABLE ! 

An attempt was made to BUILD a file larger than 
the available space on a diskette, or to copy files 
onto a diskette with no free space remaining. 

GRANS TO ALLOCATE ? 

Prompt to the user to specify the size of the file 
being built. Enter the number of grans that the file is 
to be allocated. 

CANNOT ESTABLISH DISK TYPE 

Indicates that Super Utility Plus is not able to 
recognize a disk as being formatted by one of the 
valid DOS types. 
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APPENDIX A 
Some Common Questions Answered 



My Super Utility Plus disk sometimes has trouble 
booting up in my 35-track drive. What is the problem? 

Your disk drive's read/write head may be slightly 
out of alignment. Head alignment is more critical with 
SU+ disks than normal disks, due to special formatting 
scheme on track which allows it to boot up on 
either a Model I or Model III computer. Also, check 
the motor speed of your drive 0. It should be in the 
range 297 to 303 rpm, with 300.0 to 300.5 optimal. If 
the speed falls outside this range then you will need 
to get it adjusted. 

In the table of DOS specifiers, several are given for 
each DOS type! Which one do I use? 

Whichever one you like. All the items under the 
Model I or Model III columns for a particular DOS 
type are equivalent. 

What DOS specifier should I use for a double density 
LDOS Model I data disk? 

Any one of the Model III specifiers. Double-density 
LDOS disks (with the exception of those with the 
SOLE modification) are identical for Model I and III. 




Why can't I read a single-density TRSDOS disk 
directory on my Model III? 

The problem lies in a hardware difference between 
the two computers. The Model I uses a floppy disk 
controller (FDC) chip that is different from the one 
found in the Model III. Model I TRSDOS 2.3 (and 
NEWDOS 2.1) writes its directory track using an 
address mark that the Model III FDC simply cannot 
read . Therefore, when you use SU+ to try and read 
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the directory of a Model I single-density disk on your 
Model III, SU+ is unable to find the directory. 




Is there any way around this? 

Yes, there is. SU+ has a procedure in its REPAIR 
UTILITIES called "Read-Protect Directory." This 
procedure will take a directory track and write it 
back out using the correct address marks. If you 
perform this procedure on a Model I disk while using 
your Model III, you will make its directory track 
readable to the Model III FDC, and consequently, to 
SU+. 

You should be aware, however, that doing so will 
make your disk's directory track unrecognizable to 
Model I TRSDOS, because it now has the wrong 
address mark! To restore the disk to its original 
condition, you must perform the exact same procedure 
on that disk, but using a Model I computer. 

Why won't SU+ read-protect the directory for me? 

It will, but you must tell it to. SU+ will not do 
anything to a disk unless you ask for it to be done. 

Will the same problem occur in reading a Model III 
disk on a Model I? 

Not as long as the Model I has a doubler board 
installed. The doubler board actually uses TWO floppy 
disk controller chips, one of each type, so all bases 
are covered. 



Does this problem occur with all Model I disks? 

No. It occurs mainly with TRSDOS 2.3 and 
NEWDOS 2.1 disks, which use the address mark that 
the Model III can't read. The newer operating systems 
such as LDOS, MultiDOS and DOSPLUS now write 
their directory tracks using an address mark common 
to both the Model I and Model III FDC's, so the 
problem does not arise with disks created by them. 
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Why can't I copy files to or from a double-sided disk? 
The reason is that when copying files from one 
disk to another, SU+ needs to buffer the directory 
track from both the source and destination disks in 
memory. In order to buffer two double-sided double 
density directories, 18 K of memory would be required. 
This is over ONE-THIRD the total amount of RAM 
memory in a TRS-80, and we haven't even talked 
about putting aside buffer space for the data itself 
yet! There is simply not this much free memory 
available when SU+ is running. 

Is it possible to get SU+ to read a hard disk? 

No. Super Utility Plus is strictly a floppy-only 
utility, and it doesn't even know a hard drive is 
connected. To get it to read a hard drive would mean 
adding more subroutines to handle hard drive I/O, and 
there is simply no room left in the program. 

I bought Super Utility Plus to repair my bad disks. I 
don't want to know anything about diskette structure, 
all I want to do is fix my disks! Why can't you make 
it easier to do this? 

That's like buying a set of tools to repair your car 
and then expecting the tools to do the work for you 
while you sit back and drink a beer. Super Utility 
comprises a set of tools to let you work on your 
disks. However, you still have to know what to do in 
order to use the tools effectively. Since it is 
impossible for us to anticipate the exact manner in 
which your disks were damaged, you have to do the 
work yourself, and this necessarily means learning 
something about diskette structure and formatting. If 
you don't want to learn, then find someone who knows 
what he's doing and pay him to fix your disks for you. 
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Do I need the Technical Manual in order to use Super 
Utility Plus? 

No. The Technical Manual is intended for 
experienced assembly-language programmers who are 
interested in learning something about the way Super 
Utility Plus was coded. It is not necessary for 
learning how to use Super Utility Plus. 

When should I send my SU+ disks for updating? 

First, check the version and revision number on 
your disks. This can be done by holding down the 
CLEAR and V keys at any prompt. Note these numbers 
down. Then call PowerSOFT Technical Support in 
Dallas (the number is in your manual) during regular 
office hours and ask them what the latest version and 
revision numbers are. If the numbers match the ones 
on your disk, there is no need to return your disks 
for updating. If they do not match, then you may 
return them for update. Check with PowerSOFT for 
the price of updates. 

What does the revision number represent? 

The revision number usually indicates any minor 
changes made to the current version. The version 
number itself changes only when the entire program is 
reassembled at PowerSOFT. Any patches applied to 
the program, without reassembly, will change the 
revision number. Usually these patches are applied to 
fix obscure bugs or make minor changes to optimize 
operation of the program. 




My lineprinter is an MX-80. I set the SU+ 
configuration to M for MX, and when I turned on 
DUAL mode, I got garbage on the paper. What gives? 

Your MX-80 is probably equipped with Graftrax- 
Plus. This EPSON enhancement removed the TRS-80 
block graphics characters from the printer. When you 
configured SU+; you in effect told it that your printer 
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still had the block graphics characters. You must, 
reconfigure SU+ and tell it that your printer CANNOT 
print graphics (it really can't). 

Why doesn't the COPY FILES procedure move system 
files? Is this a bug? 

No, it's not a bug, it's a safety precaution. For 
one thing, if you were copying from one DOS to 
another, you do NOT want to risk copying the system 
files! Also, several disk operating systems expect to 
find the system files at specific locations on the disk, 
and will malfunction if these files aren't where they're 
supposed to be. Because of the way SU+ "packs" a 
disk during COPY FILES, the chances are excellent 
that any system files copied will NOT land in the 
right place. This is why COPY FILES will not touch 
system files. 
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Super Utility Plus Version 3.2 

Changes from previous versions 

23 September 1983 



The current version of Super Utility Plus is 3.2 
as of September 15, 1983. This version corrects a 
number of obscure bugs and incorporates some en- 
hancements in operation. Many of the changes are 
internal and transparent to the user; of course, all 
previously issued patches have been incorporated into 
the program code. Note that as a result of reassem- 
bly, the symbol table in the SU+ 3.0 Technical 
Manual is no longer valid. See below for the proce- 
dures on obtaining updated information. 

The changes in version 3.2 of Super Utility Plus 
are documented below. 



I. Corrected Problems 

1. Double sided operations now work correctly on 
the Model I. 

2. Problems with .SPECIAL FORMAT'S handling of 
the length byte have been corrected. 

3. Problems with modification while in "View For- 
matted Buffers" (SPECIAL BACKUP & SPECIAL 
FORMAT) have been corrected. 

4. Problems with the operation of SPECIAL BACK- 
UP on the Model I and Model III have been cor- 
rected. 




5. JUMP TO MEMORY now works without prior 
patching of in-memory code. 

6. The problem with incorrect QAMs being written 
during multiple-destination STANDARD BACKUP^ 
have been corrected. 
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7. SU+ no longer crashes when attempting to write 
to a diskette which has a write-protect tab on 
it. 

8. Problems with REPAIR BOOT have been correc- 
ted. Also, the new boots contain the correct 
DOS version number in the right places. Note 
that REPAIR BOOT is still for TRSDOS disks 
only. 

9. The unused directory sectors of LDOS double- 
sided disks are now rewritten with correct DAMs 
in MOVE DIRECTORY. 




10. A one-byte change has been made in REPAIR 
GAT for double-sided LDOS disks. Previously, 
REPAIR GAT caused LDOS to reject mirror- 
image backups of these disks. This problem no 
longer occurs. 

11. Password encoding/decoding for the T1D DOS 
type has been corrected. Note also that Pass- 
word Decode for the T3D and T1D algorithms 
follow Radio Shack standard; they will NOT 
decode a 0000 password hash. 



II. Changes from version 3.1a 

1. The moving "bugs" in the screen corners have 
been removed, with the exception of the upper 
right corner, as per numerous requests from 
users. Also, the prompt cursor has been made 
less frenetic. The moving bug can still be abo- 
lished with CLEAR-A. 

2. In DISK MODIFY and MEMORY MODIFY, the 
command POO (P zero-zero) is now no longer ac- 
cepted. Previously, this was being interpreted as 
"propagate a byte for 65536 bytes" and was a 
sure-fire way to crash the entire system. 
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3. DUAL now issues carriage returns (ASCII 13) ins- 
tead of linefeeds at the end of each line. This 
will permit the use of DUAL on wide-carriage 
lineprinters that can linefeed "in place." 



4. DOUBLER=N is no longer valid for the Model III 
and MAX-80 configuration tables. This will pre- 
vent inadvertent disabling of double-density disk 
I/O for these machines. 

5. The EOF sector incompatibility between TRSDOS 
and non-TRSDOS systems on the Model III is 
now correctly handled by COPY FILES. 
Corrective measures are no longer required. 

6. The default SPEED code now toggles the Model 
4 high speed clock. Note, however, that due to 
the Model 4's numerous video and memory wait 
states, and the fact that SU+ is very video- 
intensive, the perceived speed gain will be mini- 
mal (about 10%). 

7. (MAX-80 ONLY) COPY FILES is now valid for 
LDOS double-sided and 8-inch long directories (up 
to 34 sectors in length). NEWDOS/80 type exten- 
ded directories (DDGA greater than 2) are NOT 
supported. 

8. CLEAR-V will now feature automatic revision 
number updates. The revision number changes 
whenever a patch is applied to the system. 







9. In DISPLAY ID MARKS, pressing B while scan- 
ning a double-sided disk in extended mode (X 
pressed) will lock the scan onto the back side of 
the disk until F is pressed to restore it to the 
front side. Previously the scan reverted to the 
front side automatically. 

10. FILE LOCATIONS now displays data for one 
file at a time on the screen. There is a short 
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delay after the display comes on the screen 
before another keystroke is accepted. This will 
allow you to hold down the ENTER key to scan 
through the files without skipping past one you 
want to examine more closely. 
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III. Advisory Information 

The items below are for your information only. 
They do not involve any changes to the Super Utility 
Plus program. 

1. The current MULTIDOS double-sided format, 
which uses a separate directory for each side of 
a double-sided disk, is not supported by Super 
Utility Plus, the new MULTIDOS version, which 
uses a single directory for double sided disks, is 
supported. Please contact Cosmopolitan Electro- 
nics for additional information on this version of 
MULTIDOS. Breeze/QSD has NO information 
regarding the release date of this system. 

2. For TRSDOS 6.x (Model 4) the correct DOS spe- 
cifier to use is L3D. 

3. The CHANGE DISK NAME procedure cannot 
change the AUTO command on a TRSDOS 6.x 
system disk. This is because TRSDOS 6.x keeps 
the AUTO command string in the boot sectors 
instead of in the directory GAT sector where 
SU+ expects to find it. 



4. For NEWDOS/80 Version 2, the "R" modifier can 
now be used for all double-density operations ex- 
cept Model I double-density STANDARD BACKUP. 
For Model I double density backups, use N1D 
ONLY. 

5. (MAX-80 ONLY) When attempting to access a 
combination of 5.25" and 8" drives, remember 
that in Super Utility Plus, drive refers to phy- 
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sical drive 0. not logical drive 0! You may need 
to change the boot switch settings in order to 
access the correct drive. 

The DRIVE STATUS procedure cannot correctly 
detect the "no diskette" condition on certain disk 
drives, most notably the new microprocessor- 
controlled drives such as the Tandon TM-101, or 
8" drives on the MAX-80. Such drives may cause 
SU+ to return a "DRIVE NOT IN SYSTEM" mes- 
sage instead. Note that this will result in that 
drive being disabled in the configuration tables!. 
If this occurs you will have to go to the config- 
uration table and restore it to the system (re- 
place the "-" with a "+"). 




7. Note that CLEAR-I (the INKEY switch) works 
only on those prompts where the maximum num- 
ber of allowable reply keystrokes is ONR If a 
prompt can accept more than one keystroke for 
a reply, then the INKEY function will not be 
active, as there is no a priori way of telling 
when the user has completed his input. Note also 
that CLEAR-I (as well as CLEAR-A) is subject to 
automatic keyboard repeat. If it does not "take" 
you may have held it down too long. 

8. The use of * at the FORMAT "Use Configura- 
tion?" prompt is not supported. The only valid 
special character at this prompt is !, which for- 
ces formatting to take place even if the target 
disk contains data. The * special command, how- 
ever, IS valid at the "Format Disks ?" prompt of 
STANDARD BACKUP. In this case it will cause 
SU+ to skip the verification, cycle. The ! special 
command is also valid in STANDARD BACKUP. 

9. On the Model III, ASCII values through 31 are 
displayed as the corresponding Model III special 
characters. On the Model I, the ASCII side of a 
sector or memory display will show the ASCII 
value PLUS 40H. Thus a byte 00 will display as 
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"@", byte 01 will display as "A", and so on. Re- 
gardless of how they are displayed on the video, 
however, byte values in the range 00 through 31 
will be translated to periods when sent to the 
lineprinter. 




IV. Obtaining Updated Information 

If you already own the SU+ 3.0 TECHNICAL 
MANUAL you may order an updated symbol table, 
covering the changes in version 3.2, from 

PowerSOFT Products 

11500 Stemmons Expressway, Suite 125 

Dallas, TX 75229 

214/484-2976 

The symbol table will contain the address referen- 
ces of all symbols used in SU+ version 3.2; however, 
no additional documentation is available for those not 
already documented in the Technical Manual. The 
cost of the update pages is $3.00 per set, postpaid. 
When ordering, be sure to include your SU+ serial 
number and state whether or not you want the MAX- 
80 symbol table as well. 



A new User's Manual for Super Utility Plus 3.2 
(pages only, no binder) may be purchased by regis- 
tered SU+ owners for $12.00 plus $1.00 shipping and 
handling. This manual will incorporate all information 
found in the preceding pages. Send all orders to the 
address above. Be sure to include your SU+ serial 
number. This offer is for registered owners only. Or- 
ders without an accompanying serial number will be 
returned unfilled. 




